> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/de/system-administration/configuring-ptp.md).

# Konfigurieren von PTP in VergeOS

Konfigurieren Sie das Precision Time Protocol (PTP) anstelle von NTP für die VergeOS-Zeitsynchronisierung, einschließlich aller PTP-Einstellungen, ihrer Standardwerte und wie Sie wieder zu NTP zurückkehren.

## Überblick

{% hint style="info" %}
**Wichtige Punkte**

* Der PTP-Modus ersetzt NTP für die Synchronisierung der Systemzeit. NTP wird nicht ausgeführt, solange der PTP-Modus aktiviert ist.
* PTP benötigt ein physisches Netzwerk, das mit PTP-fähigen Switches und einer PTP-Grandmaster-Clock verbunden ist.
* Hardware-Zeitstempel bieten die höchste Genauigkeit. Sie sind standardmäßig aktiviert.
* Die **Zeiteinstellungen** Seite zeigt den Synchronisierungsstatus jedes Knotens. VergeOS löst einen Alarm aus, wenn ein Knoten länger als zwei Minuten nicht synchron ist.
* Um die Änderung rückgängig zu machen, setzen Sie **Modus** wieder auf **NTP**.
  {% endhint %}

Dieser Artikel erklärt, wie Sie die Zeitsynchronisierung in VergeOS von NTP auf Precision Time Protocol (PTP) umstellen und wie Sie jede PTP-Option festlegen. Verwenden Sie PTP nur, wenn Ihre Workloads eine präzisere Zeit benötigen, als NTP liefert, zum Beispiel im Broadcast-Bereich, im Finanzhandel, in der Telekommunikation oder in der industriellen Automatisierung.

{% hint style="danger" %}
Aktivieren Sie PTP nur, wenn Ihre NICs, Switches und der Grandmaster PTP unterstützen. Eine falsche PTP-Konfiguration führt auf jedem Knoten im System zu einer falschen Zeit.
{% endhint %}

## Voraussetzungen

* VergeOS 26.2 oder höher.
* Ein Benutzer mit Administratorrechten für das System.
* Ein physisches Netzwerk, das mit PTP-fähigen Switches oder Zeitgeräten verbunden ist.
* Eine PTP-Grandmaster-Clock, die die Knoten erreichen können, und ihr PTP-Profil: Domain, Transport und Verzögerungsmechanismus.
* NICs, die Hardware-Zeitstempelung unterstützen, für die höchste Genauigkeit.

## Schritte

{% hint style="warning" %}
Wenn Sie **Modus** auf **PTP**, wird NTP beendet. Wenn die Knoten keinen PTP-Master erreichen können, haben sie keine Zeitquelle.
{% endhint %}

1. Navigieren Sie zu **System > Zeiteinstellungen**.
2. Klicken Sie auf **Einstellungen bearbeiten** im linken Menü.
3. In der **Modus** Liste wählen Sie **PTP**. Die PTP-Felder werden im **Zeiteinstellungen** Bereich und die **Erweiterte PTP-Einstellungen** Bereich angezeigt.
4. Passen Sie die Grundeinstellungen an Ihr PTP-Netzwerk an. Siehe [Grundeinstellungen](#basic-settings).
5. Wenn Ihr PTP-Profil Nicht-Standardwerte benötigt, legen Sie sie im **Erweiterte PTP-Einstellungen** Bereich fest. Siehe [Erweiterte Einstellungen](#advanced-settings).
6. Klicken Sie auf **Absenden**.

Die **Zeiteinstellungen** Seite wird geöffnet und zeigt den neuen Modus an.

## Konfiguration überprüfen

1. Navigieren Sie zu **System > Zeiteinstellungen**.
2. Stellen Sie sicher, dass im Synchronisierungsstatusbereich jeder Knoten als synchronisiert angezeigt wird. Wenn ein Knoten länger als zwei Minuten nicht synchron bleibt, löst VergeOS einen Alarm aus.
3. Stellen Sie auf Ihrem Grandmaster oder PTP-Switch sicher, dass jeder Knoten auf der richtigen Domain als PTP-Client angezeigt wird.
4. Stellen Sie sicher, dass Anwendungen, die von präziser Zeit abhängen, korrekt funktionieren.

Wenn die Synchronisierung nicht stabil wird, kehren Sie zu NTP zurück. Untersuchen Sie dann Ihr PTP-Netzwerk und Ihre Einstellungen.

## Zu NTP zurückkehren

1. Navigieren Sie zu **System > Zeiteinstellungen**.
2. Klicken Sie auf **Einstellungen bearbeiten**.
3. In der **Modus** Liste wählen Sie **NTP**.
4. Klicken Sie auf **Absenden**.

Die **Zeiteinstellungen** Seite zeigt **Modus: NTP**. Der **NTP-Synchronisierungsstatus** Bereich zeigt jeden Knoten als **Synchronisiert**.

## Gastzeit

VergeOS reicht den kvmclock-Parameter an die Gäste weiter. Gäste, die PTP unterstützen, können sich genau mit der Host-Uhr synchronisieren.

## Referenz zu PTP-Einstellungen

### Grundeinstellungen

Diese Einstellungen befinden sich im **Zeiteinstellungen** Bereich angezeigt.

| Feld                               | Standard | Werte                   | Beschreibung                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------- | -------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **PTP-Schnittstellennetzwerk**     | Keine    | Ein physisches Netzwerk | Das physische Netzwerk, das PTP-Verkehr überträgt. Im PTP-Modus erforderlich. Wählen Sie ein Netzwerk aus, das mit PTP-fähigen Switches oder Zeitgeräten verbunden ist.                                                                                                                                                                                                    |
| **PTP-Transport**                  | UDPv4    | UDPv4, UDPv6, L2        | Der Transport für PTP-Nachrichten. Verwenden Sie den Transport Ihres PTP-Profils. 802.1AS (gPTP) verwendet L2.                                                                                                                                                                                                                                                             |
| **PTP-Domain**                     | 0        | 0-127                   | Die Nummer der PTP-Domain. Verwenden Sie die Domain Ihres Grandmasters.                                                                                                                                                                                                                                                                                                    |
| **PTP-Verzögerungsmechanismus**    | E2E      | E2E, P2P, Auto          | Wie die Pfadverzögerung gemessen wird: End-to-End (E2E) oder Peer-to-Peer (P2P). Verwenden Sie den Mechanismus Ihres PTP-Netzwerks.                                                                                                                                                                                                                                        |
| **Hardware-Zeitstempel verwenden** | Ein      | Ein, Aus                | Mit Hardware-Zeitstempeln steuert ptp4l die Hardware-Uhr der NIC, und phc2sys kopiert diese Zeit in die Systemuhr. Mit Software-Zeitstempeln steuert ptp4l direkt die Systemuhr, allerdings mit geringerer Genauigkeit. Wenn Ihre NICs Hardware-Zeitstempelung nicht unterstützen, schalten Sie dies aus. VergeOS fällt nicht automatisch auf Software-Zeitstempel zurück. |

### Erweiterte Einstellungen

Diese Einstellungen befinden sich im **Erweiterte PTP-Einstellungen** Bereich. Die Standardwerte funktionieren mit den meisten PTP-Netzwerken. Ändern Sie einen Wert nur, wenn Ihr PTP-Profil oder Grandmaster ihn benötigt.

| Feld                                                   | Standard | Werte        | Beschreibung                                                                                                                                                                                                                    |
| ------------------------------------------------------ | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Clock-Priorität 1**                                  | 128      | 0-255        | Priorität bei der Uhrenauswahl im Best Master Clock Algorithm (BMCA). Ein niedrigerer Wert bedeutet eine höhere Priorität.                                                                                                      |
| **Clock-Priorität 2**                                  | 128      | 0-255        | BMCA-Entscheidungskriterium, wenn Clock-Priorität 1 gleich ist.                                                                                                                                                                 |
| **Zweistufige Uhr**                                    | Ein      | Ein, Aus     | Ein: Der Zeitstempel wird in einer Follow\_Up-Nachricht gesendet. Aus: Der Zeitstempel befindet sich in der Sync-Nachricht (One-Step).                                                                                          |
| **Log-Sync-Intervall**                                 | 0        | -6 bis 1     | Sync-Nachrichtenrate, als log2-Sekunden: 0 = 1 s, -1 = 0,5 s, -3 = 0,125 s.                                                                                                                                                     |
| **Log-Announce-Intervall**                             | 1        | -3 bis 3     | Announce-Nachrichtenrate, als log2-Sekunden: 0 = 1 s, 1 = 2 s, 2 = 4 s.                                                                                                                                                         |
| **Log-Mindestintervall für Delay-Anfragen**            | 0        | -4 bis 1     | Minimale Rate für Delay-Anfragen, als log2-Sekunden. Wird mit dem E2E-Verzögerungsmechanismus verwendet.                                                                                                                        |
| **Log-Mindestintervall für P-Delay-Anfragen**          | 0        | -4 bis 1     | Minimale Peer-Delay-Anforderungsrate, als log2-Sekunden. Wird mit dem P2P-Verzögerungsmechanismus verwendet.                                                                                                                    |
| **Unicast-Übertragung**                                | Aus      | Ein, Aus     | Verwenden Sie Unicast anstelle von Multicast. Schalten Sie dies nur ein, wenn Ihre PTP-Peers Unicast unterstützen.                                                                                                              |
| **DSCP-Ereignisnachrichten (Port 319)**                | 0        | 0-63         | DSCP-Wert für PTP-Ereignisnachrichten, für QoS.                                                                                                                                                                                 |
| **DSCP-Allgemeinnachrichten (Port 320)**               | 0        | 0-63         | DSCP-Wert für PTP-Allgemeinnachrichten, für QoS.                                                                                                                                                                                |
| **Immer Master (BMCA deaktivieren)**                   | Aus      | Ein, Aus     | Der Port fungiert immer als Master und verwendet kein BMCA. Schalten Sie dies nur ein, wenn VergeOS die Zeitquelle für das PTP-Netzwerk ist. Schalten Sie es nicht ein, wenn ein anderer Grandmaster dieselbe Domain verwendet. |
| **Announce-Nachrichten unterdrücken**                  | Aus      | Ein, Aus     | Stoppt das Senden und Empfangen von Announce-Nachrichten.                                                                                                                                                                       |
| **Delay-Request-Nachrichten unterdrücken**             | Aus      | Ein, Aus     | Stoppt das Senden von Delay-Request-Nachrichten.                                                                                                                                                                                |
| **Follow\_Up-Informationen einschließen**              | Aus      | Ein, Aus     | Fügt Follow\_Up-Nachrichten das Follow-up-Information-TLV hinzu. Einige Profile, wie 802.1AS, benötigen es.                                                                                                                     |
| **Transport-spezifisches Feld**                        | 0        | 0-255        | Das PTP-Feld transportSpecific. Für 802.1AS (gPTP) ist dieser Wert typischerweise 1.                                                                                                                                            |
| **Maximale Ausbreitungsverzögerung zum Nachbarn (ns)** | 20000000 | Nanosekunden | Die maximal zulässige Ausbreitungsverzögerung zu einem Nachbarn. Dies ist eine Grenze, keine erwartete Verzögerung.                                                                                                             |
| **Sync-Empfangs-Timeout**                              | 0        | 0-255        | Anzahl der Sync-Intervalle vor einem Timeout. 0 deaktiviert das Timeout.                                                                                                                                                        |
| **Announce-Empfangs-Timeout**                          | 3        | 1-255        | Anzahl der Announce-Intervalle vor einem Timeout.                                                                                                                                                                               |

## Zusätzliche Ressourcen

* [Zeiteinstellungen](https://app.gitbook.com/s/pODKGSQETqL1gSqyxIq3/system-administration/time-settings)
* [Systemeinstellungen](/run-the-platform/de/systemadministration/settings-overview.md)
* [VergeOS 26.2 Versionshinweise](/release-notes/de/2026/26-2-release-notes.md)

{% hint style="info" %}
**Brauchen Sie Hilfe?**

Wenn Sie Fragen oder Probleme mit diesem Verfahren haben, wenden Sie sich an das VergeOS-Supportteam.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/knowledge-base/de/system-administration/configuring-ptp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
