Skip to content

OpenVPN

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
proxies:
  - name: "openvpn"
    type: openvpn
    server: vpn.example.com
    port: 1194
    proto: udp
    # auth-user-pass mode
    username: "user"
    password: "pass"
    # Certificate mode (Alternative to the above)
    # cert: |
    #   -----BEGIN CERTIFICATE-----
    #   ...
    #   -----END CERTIFICATE-----
    # key: |
    #   -----BEGIN PRIVATE KEY-----
    #   ...
    #   -----END PRIVATE KEY-----
    # tls-auth: |
    #   -----BEGIN OpenVPN Static key V1-----
    #   ...
    #   -----END OpenVPN Static key V1-----
    # key-direction: "1"
    ca: |
      -----BEGIN CERTIFICATE-----
      MIIB...example
      -----END CERTIFICATE-----
    # tls-crypt: |
    #  -----BEGIN OpenVPN Static key V1-----
    #  ...
    #  -----END OpenVPN Static key V1-----
    # tls-crypt-v2: |
    #  -----BEGIN OpenVPN tls-crypt-v2 client key-----
    #  ...
    #  -----END OpenVPN tls-crypt-v2 client key-----
    # peer-info:
    #   IV_HWADDR: "52:54:00:ff:72:87"
    #   UV_DEVICE_ID: "laptop-001"
    # ping: 10
    # ping-restart: 60
    # handshake-timeout: 30
    # dev: tun
    # cipher: AES-128-GCM
    # data-ciphers: [AES-256-GCM, AES-128-GCM]
    # data-ciphers-fallback: AES-128-CBC
    # auth: SHA256
    # comp-lzo: "no"
    udp: true
    # mtu: 1500
    # dialer-proxy: "ss1"
    # remote-dns-resolve: true
    # dns: [ 1.1.1.1, 8.8.8.8 ]

Common Fields

server

Required, the address of the OpenVPN server.

port

Required, the port of the OpenVPN server. Defaults to 1194.

proto

Optional, protocol type. Supports udp or tcp. Defaults to udp.

username / password

Optional, the username and password required for auth-user-pass authentication mode.

Note: Must choose between these or cert / key. Both pairs cannot be empty at the same time.

ca

Required, CA certificate content. Copy this from the <ca> tag in your .ovpn file.

cert

Optional, client certificate content. Copy this from the <cert> tag in your .ovpn file. Can be omitted when using username/password authentication.

key

Optional, client private key content. Copy this from the <key> tag in your .ovpn file. Can be omitted when using username/password authentication.

tls-auth

Optional, copy from the <tls-auth> tag in the .ovpn file. Mutually exclusive with tls-crypt / tls-crypt-v2.

key-direction

Optional, required when using tls-auth, supports "1" or "0". If left blank or as an empty string, it defaults to bidirectional mode.

tls-crypt

Optional, TLS encryption key. Copy this from the <tls-crypt> tag in your .ovpn file; do not include the tags themselves. Mutually exclusive with tls-auth / tls-crypt-v2.

tls-crypt-v2

Optional, copy the client key from the <tls-crypt-v2> tag in your .ovpn file; do not include the tags themselves. Mutually exclusive with tls-auth / tls-crypt.

ping

Optional, defaults to 0.

ping-restart

Optional, defaults to 0.

peer-info

Optional key-value pairs passed to the server as peer-info. They are appended after the built-in IV_VER/IV_PROTO/IV_CIPHERS values and can be used by the server for admission decisions.

handshake-timeout

Optional handshake timeout in seconds. The default value is 0, meaning only the outer connection timeout is used.

dev

Optional, virtual network interface type. Currently only tun is supported. Defaults to tun.

cipher

Optional, encryption method. Supports AES-128-GCM / AES-256-GCM / AES-128-CBC / AES-256-CBC / CHACHA20-POLY1305. Defaults to AES-128-GCM. AES-CBC will be treated as AES-128-CBC.

data-ciphers

Optional, data channel cipher negotiation list, sends IV_CIPHERS to the server; the cipher list pushed by the server is intersected with the local list, and the first matching item is selected.

data-ciphers-fallback

Optional, fallback cipher when negotiation fails (corresponds to --data-ciphers-fallback)

auth

Optional, data authentication algorithm. Supports MD5 /SHA1 / SHA256/ SHA384 / SHA512. Defaults to SHA256. AEAD ciphers will ignore the auth configuration.

comp-lzo

Optional, data compression method. Supported values: yes, no, adaptive.

udp

Optional, whether to use the UDP protocol. true for UDP, false for TCP.

mtu

Optional, Maximum Transmission Unit. Defaults to 1500.

dialer-proxy

Optional, specifies the identifier for an outbound proxy. If set, the OpenVPN connection will be established through the specified proxy.

remote-dns-resolve

Optional, whether to force remote DNS resolution. Defaults to false.

dns

Optional, only effective when remote-dns-resolve is set to true. Specifies a list of DNS server addresses.