config.yml 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525
  1. # This is the nebula example configuration file. You must edit, at a minimum, the static_host_map, lighthouse, and firewall sections
  2. # Some options in this file are HUPable, including the pki section. (A HUP will reload credentials from disk without affecting existing tunnels)
  3. # PKI defines the location of credentials for this node. Each of these can also be inlined by using the yaml ": |" syntax.
  4. pki:
  5. # The CAs that are accepted by this node. Must contain one or more certificates created by 'nebula-cert ca'
  6. # A version 3 CA only accepts version 3 certificates, which only post-quantum hybrid handshakes use. To also
  7. # accept version 2 certificates from it, list its v2 form as well (nebula-cert print shows its v2Fingerprint).
  8. # Leaving the v2 form out is how a node requires post-quantum authentication.
  9. ca: /etc/nebula/ca.crt
  10. # cert may hold a version 3 certificate, which also serves as its v2 form for classical handshakes. key then
  11. # holds the version 3 key from 'nebula-cert keygen -version 3' or 'nebula-cert sign'.
  12. cert: /etc/nebula/host.crt
  13. key: /etc/nebula/host.key
  14. # blocklist is a list of certificate fingerprints that we will refuse to talk to
  15. # A version 3 certificate has two fingerprints, its own and its v2 form's. Blocking the v2 one blocks both,
  16. # blocking the v3 one leaves the v2 form usable in classical handshakes, so list both.
  17. #blocklist:
  18. # - c99d4e650533b92061b09918e838a5a0a6aaee21eed1d12fd937682865936c72
  19. # disconnect_invalid is a toggle to force a client to be disconnected if the certificate is expired or invalid.
  20. #disconnect_invalid: true
  21. # initiating_version controls which certificate version is used when initiating handshakes.
  22. # This setting only applies if both a v1 and a v2 certificate are configured, in which case it will default to `1`.
  23. # Once all hosts in the mesh are configured with both a v1 and v2 certificate then this should be changed to `2`.
  24. # After all hosts in the mesh are using a v2 certificate then v1 certificates are no longer needed.
  25. # initiating_version: 1
  26. # The static host map defines a set of hosts with fixed IP addresses on the internet (or any network).
  27. # A host can have multiple fixed IP addresses defined here, and nebula will try each when establishing a tunnel.
  28. # The syntax is:
  29. # "{nebula ip}": ["{routable ip/dns name}:{routable port}"]
  30. # Example, if your lighthouse has the nebula IP of 192.168.100.1 and has the real ip address of 100.64.22.11 and runs on port 4242:
  31. static_host_map:
  32. "192.168.100.1": ["100.64.22.11:4242"]
  33. # The static_map config stanza can be used to configure how the static_host_map behaves.
  34. #static_map:
  35. # cadence determines how frequently DNS is re-queried for updated IP addresses when a static_host_map entry contains
  36. # a DNS name.
  37. #cadence: 30s
  38. # network determines the type of IP addresses to ask the DNS server for. The default is "ip4" because nodes typically
  39. # do not know their public IPv4 address. Connecting to the Lighthouse via IPv4 allows the Lighthouse to detect the
  40. # public address. Other valid options are "ip6" and "ip" (returns both.)
  41. #network: ip4
  42. # lookup_timeout is the DNS query timeout.
  43. #lookup_timeout: 250ms
  44. lighthouse:
  45. # am_lighthouse is used to enable lighthouse functionality for a node. This should ONLY be true on nodes
  46. # you have configured to be lighthouses in your network
  47. am_lighthouse: false
  48. # serve_dns optionally starts a dns listener that responds to various queries and can even be
  49. # delegated to for resolution
  50. #serve_dns: false
  51. #dns:
  52. # The DNS host defines the IP to bind the dns listener to. This also allows binding to the nebula node IP.
  53. #host: 0.0.0.0
  54. #port: 53
  55. # interval is the number of seconds between updates from this node to a lighthouse.
  56. # during updates, a node sends information about its current IP addresses to each node.
  57. interval: 60
  58. # hosts is a list of lighthouse hosts this node should report to and query from
  59. # IMPORTANT: THIS SHOULD BE EMPTY ON LIGHTHOUSE NODES
  60. # IMPORTANT2: THIS SHOULD BE LIGHTHOUSES' NEBULA IPs, NOT LIGHTHOUSES' REAL ROUTABLE IPs
  61. hosts:
  62. - "192.168.100.1"
  63. # remote_allow_list allows you to control ip ranges that this node will
  64. # consider when handshaking to another node. By default, any remote IPs are
  65. # allowed. You can provide CIDRs here with `true` to allow and `false` to
  66. # deny. The most specific CIDR rule applies to each remote. If all rules are
  67. # "allow", the default will be "deny", and vice-versa. If both "allow" and
  68. # "deny" IPv4 rules are present, then you MUST set a rule for "0.0.0.0/0" as
  69. # the default. Similarly if both "allow" and "deny" IPv6 rules are present,
  70. # then you MUST set a rule for "::/0" as the default.
  71. #remote_allow_list:
  72. # Example to block IPs from this subnet from being used for remote IPs.
  73. #"172.16.0.0/12": false
  74. # A more complicated example, allow public IPs but only private IPs from a specific subnet
  75. #"0.0.0.0/0": true
  76. #"10.0.0.0/8": false
  77. #"10.42.42.0/24": true
  78. # EXPERIMENTAL: This option may change or disappear in the future.
  79. # Optionally allows the definition of remote_allow_list blocks
  80. # specific to an inside VPN IP CIDR.
  81. #remote_allow_ranges:
  82. # This rule would only allow only private IPs for this VPN range
  83. #"10.42.42.0/24":
  84. #"192.168.0.0/16": true
  85. # local_allow_list allows you to filter which local IP addresses we advertise
  86. # to the lighthouses. This uses the same logic as `remote_allow_list`, but
  87. # additionally, you can specify an `interfaces` map of regular expressions
  88. # to match against interface names. The regexp must match the entire name.
  89. # All interface rules must be either true or false (and the default will be
  90. # the inverse). CIDR rules are matched after interface name rules.
  91. # Default is all local IP addresses.
  92. #local_allow_list:
  93. # Example to block tun0 and all docker interfaces.
  94. #interfaces:
  95. #tun0: false
  96. #'docker.*': false
  97. # Example to only advertise this subnet to the lighthouse.
  98. #"10.0.0.0/8": true
  99. # advertise_addrs are routable addresses that will be included along with discovered addresses to report to the
  100. # lighthouse, the format is "ip:port". `port` can be `0`, in which case the actual listening port will be used in its
  101. # place, useful if `listen.port` is set to 0.
  102. # This option is mainly useful when there are static ip addresses the host can be reached at that nebula can not
  103. # typically discover on its own. Examples being port forwarding or multiple paths to the internet.
  104. #advertise_addrs:
  105. #- "1.1.1.1:4242"
  106. #- "1.2.3.4:0" # port will be replaced with the real listening port
  107. # EXPERIMENTAL: This option may change or disappear in the future.
  108. # This setting allows us to "guess" what the remote might be for a host
  109. # while we wait for the lighthouse response.
  110. #calculated_remotes:
  111. # For any Nebula IPs in 10.0.10.0/24, this will apply the mask and add
  112. # the calculated IP as an initial remote (while we wait for the response
  113. # from the lighthouse). Both CIDRs must have the same mask size.
  114. # For example, Nebula IP 10.0.10.123 will have a calculated remote of
  115. # 192.168.1.123
  116. #10.0.10.0/24:
  117. #- mask: 192.168.1.0/24
  118. # port: 4242
  119. # Port Nebula will be listening on. The default here is 4242. For a lighthouse node, the port should be defined,
  120. # however using port 0 will dynamically assign a port and is recommended for roaming nodes.
  121. listen:
  122. # To listen on only ipv4, use "0.0.0.0"
  123. host: "::"
  124. port: 4242
  125. # Sets the max number of packets to pull from the kernel for each syscall (under systems that support recvmmsg)
  126. # default is 64, does not support reload
  127. # Note: on Linux with UDP GRO (kernel 5.10+), each receive slot is sized for a full 64KiB coalesced
  128. # superpacket, so the receive scratch is batch * 64KiB per listening socket (~4MiB per routine at the
  129. # default of 64). Lower this to trade peak per-syscall throughput for memory on constrained hosts.
  130. #batch: 64
  131. # Linux only. Configure socket buffers for the udp side (outside), leave unset to use the system defaults. Values will be doubled by the kernel
  132. # Default is net.core.rmem_default and net.core.wmem_default (/proc/sys/net/core/rmem_default and /proc/sys/net/core/rmem_default)
  133. # Maximum is limited by memory in the system, SO_RCVBUFFORCE and SO_SNDBUFFORCE is used to avoid having to raise the system wide
  134. # max, net.core.rmem_max and net.core.wmem_max
  135. read_buffer: 3412512
  136. write_buffer: 3412512
  137. # On Windows only
  138. # When true, Nebula installs a WFP (Windows Filtering Platform) PERMIT filter scoped to UDP at the listener port.
  139. # WFP sits below Windows Defender Firewall, so this lets peer handshakes reach Nebula's outside socket regardless
  140. # of WDF's inbound rules.
  141. # Default true; set to false to leave WDF in charge of inbound decisions on the listener port. Not reloadable.
  142. #windows_bypass_wdf: true
  143. # On macOS only
  144. # macOS scopes the udp socket to the interface it was created on, so moving between networks (wifi to wired,
  145. # office to home) leaves Nebula sending out an interface that no longer has a route. When true, Nebula watches
  146. # the routing socket and rebinds the listener once the change settles.
  147. # iOS does not use this, the host app drives the same rebind itself.
  148. # Default true. Not reloadable.
  149. #rebind_on_network_change: true
  150. # By default, Nebula replies to packets it has no tunnel for with a "recv_error" packet. This packet helps speed up reconnection
  151. # in the case that Nebula on either side did not shut down cleanly. This response can be abused as a way to discover if Nebula is running
  152. # on a host though. This option lets you configure if you want to send "recv_error" packets always, never, or only to private network remotes.
  153. # valid values: always, never, private
  154. # This setting is reloadable.
  155. #send_recv_error: always
  156. # Similar to send_recv_error, this option lets you configure if you want to accept "recv_error" packets from remote hosts.
  157. # valid values: always, never, private
  158. # This setting is reloadable.
  159. #accept_recv_error: always
  160. # The so_sock option is a Linux-specific feature that allows all outgoing Nebula packets to be tagged with a specific identifier.
  161. # This tagging enables IP rule-based filtering. For example, it supports 0.0.0.0/0 unsafe_routes,
  162. # allowing for more precise routing decisions based on the packet tags. Default is 0 meaning no mark is set.
  163. # This setting is reloadable.
  164. #so_mark: 0
  165. # the udp_offloads setting controls if Nebula will attempt to enable GSO and GRO for its UDP socket(s). Linux only, not reloadable.
  166. # udp_offloads: false
  167. # Routines is the number of thread pairs to run that consume from the tun and UDP queues.
  168. # Currently, this defaults to 1 which means we have 1 tun queue reader and 1
  169. # UDP queue reader. Setting this above one will set IFF_MULTI_QUEUE on the tun
  170. # device and SO_REUSEPORT on the UDP socket to allow multiple queues.
  171. # This option is only supported on Linux.
  172. #routines: 1
  173. punchy:
  174. # Continues to punch inbound/outbound at a regular interval to avoid expiration of firewall nat mappings
  175. # This setting is reloadable.
  176. punch: true
  177. # respond means that a node you are trying to reach will connect back out to you if your hole punching fails
  178. # this is extremely useful if one node is behind a difficult nat, such as a symmetric NAT
  179. # Default is false
  180. # This setting is reloadable.
  181. #respond: true
  182. # delays a punch response for misbehaving NATs, default is 1 second.
  183. # This setting is reloadable.
  184. #delay: 1s
  185. # set the delay before attempting punchy.respond. Default is 5 seconds. respond must be true to take effect.
  186. # This setting is reloadable.
  187. #respond_delay: 5s
  188. # Cipher allows you to choose between the available ciphers for your network. Options are chachapoly or aes
  189. # IMPORTANT: this value must be identical on ALL NODES/LIGHTHOUSES. We do not/will not support use of different ciphers simultaneously!
  190. #cipher: aes
  191. # Preferred ranges is used to define a hint about the local network ranges, which speeds up discovering the fastest
  192. # path to a network adjacent nebula node.
  193. # This setting is reloadable.
  194. #preferred_ranges: ["172.16.0.0/24"]
  195. # sshd can expose informational and administrative functions via ssh. This can expose informational and administrative
  196. # functions, and allows manual tweaking of various network settings when debugging or testing.
  197. #sshd:
  198. # Toggles the feature
  199. #enabled: true
  200. # Host and port to listen on, port 22 is not allowed for your safety
  201. #listen: 127.0.0.1:2222
  202. # A file containing the ssh host private key to use
  203. # A decent way to generate one: ssh-keygen -t ed25519 -f ssh_host_ed25519_key -N "" < /dev/null
  204. #host_key: ./ssh_host_ed25519_key
  205. # Authorized users and their public keys
  206. #authorized_users:
  207. #- user: steeeeve
  208. # keys can be an array of strings or single string
  209. #keys:
  210. #- "ssh public key string"
  211. # Trusted SSH CA public keys. These are the public keys of the CAs that are allowed to sign SSH keys for access.
  212. #trusted_cas:
  213. #- "ssh public key string"
  214. # sandbox_dir restricts file paths for profiling commands (start-cpu-profile, save-heap-profile,
  215. # save-mutex-profile) to the specified directory. Relative paths will be resolved within this directory,
  216. # and absolute paths outside of it will be rejected. Default is $TMP/nebula-debug.
  217. # The directory is NOT automatically created.
  218. # Overriding this to "" is the same as "/" and will allow overwriting any path on the host.
  219. #sandbox_dir: /var/tmp/nebula-debug
  220. # EXPERIMENTAL: relay support for networks that can't establish direct connections.
  221. relay:
  222. # Relays are a list of Nebula IP's that peers can use to relay packets to me.
  223. # IPs in this list must have am_relay set to true in their configs, otherwise
  224. # they will reject relay requests.
  225. #relays:
  226. #- 192.168.100.1
  227. #- <other Nebula VPN IPs of hosts used as relays to access me>
  228. # Set am_relay to true to permit other hosts to list my IP in their relays config. Default false.
  229. am_relay: false
  230. # Set use_relays to false to prevent this instance from attempting to establish connections through relays.
  231. # default true
  232. use_relays: true
  233. # Configure the private interface. Note: addr is baked into the nebula certificate
  234. tun:
  235. # When tun is disabled, a lighthouse can be started without a local tun interface (and therefore without root)
  236. disabled: false
  237. # Name of the device. If not set, a default will be chosen by the OS.
  238. # For macOS: if set, must be in the form `utun[0-9]+`.
  239. # For NetBSD: Required to be set, must be in the form `tun[0-9]+`
  240. dev: nebula1
  241. # Toggles forwarding of local broadcast packets, the address of which depends on the ip/mask encoded in pki.cert
  242. drop_local_broadcast: false
  243. # Toggles forwarding of multicast packets
  244. drop_multicast: false
  245. # Sets the transmit queue length, if you notice lots of transmit drops on the tun it may help to raise this number. Default is 5000
  246. tx_queue: 5000
  247. # Default MTU for every packet, safe setting is (and the default) 1300 for internet based traffic
  248. # Anything above 8937, here or on a route below, is capped to 8937 with a warning
  249. mtu: 1300
  250. # the use_offloads setting controls if Nebula will attempt to enable GSO and GRO for the tun device. Linux only, not reloadable.
  251. #use_offloads: false
  252. # Linux only. pin_threads pins each tun reader/encrypt OS thread to a single CPU. This keeps every goroutine's
  253. # batched sends flowing through one XPS-selected NIC TX ring, so packets within a flow stay ordered on the wire
  254. # instead of being sprayed across multiple TX rings and reordered. Not reloadable. Coerced to false if routines <= 1.
  255. #pin_threads: true
  256. # pin_threads_key helps the CPU-auto-selector shuffle which CPUs are chosen for pinning.
  257. # Valid options are "pid" or "port". Use "port" if you want Nebula to choose the same cores every time, which is nice for benchmarking.
  258. # Linux only, not reloadable.
  259. #pin_threads_key: "pid"
  260. # Linux only. cpu_affinity overrides which CPUs the tun reader threads pin to: a list of CPU IDs, one per routine
  261. # (see the top-level `routines` setting). Lists shorter than `routines` are modulo-cycled across the queues; extra
  262. # entries are ignored. IDs must be within the process's allowed CPU set, so this respects taskset / cgroup cpusets;
  263. # a non-integer or not-allowed entry disables the override, leaving the default pin selection described below.
  264. # Only meaningful while pin_threads is true. Not reloadable.
  265. # When unset (or rejected), the default spread prefers performance cores on heterogeneous CPUs (ARM big.LITTLE,
  266. # Intel P/E hybrids, AMD compact cores), keeps all readers on one NUMA node and on distinct physical cores when the
  267. # topology allows (SMT siblings last), leaves CPU 0's physical core as a last resort, and rotates its starting
  268. # point per instance (keyed by the bound UDP port) so co-located nebulas don't stack their readers onto the
  269. # same cores.
  270. #cpu_affinity:
  271. # - 2
  272. # - 4
  273. # Route based MTU overrides, you have known vpn ip paths that can support larger MTUs you can increase/decrease them here
  274. routes:
  275. #- mtu: 8800
  276. # route: 10.0.0.0/16
  277. # Unsafe routes allows you to route traffic over nebula to non-nebula nodes
  278. # Unsafe routes should be avoided unless you have hosts/services that cannot run nebula
  279. # Supports weighted ECMP if you define a list of gateways, this can be used for load balancing or redundancy to hosts outside of nebula
  280. # NOTES:
  281. # * You will only see a single gateway in the routing table if you are not on linux
  282. # * If a gateway is not reachable through the overlay another gateway will be selected to send the traffic through, ignoring weights
  283. #
  284. # unsafe_routes:
  285. # # Multiple gateways without defining a weight defaults to a weight of 1, this will balance traffic equally between the three gateways
  286. # - route: 192.168.87.0/24
  287. # via:
  288. # - gateway: 10.0.0.1
  289. # - gateway: 10.0.0.2
  290. # - gateway: 10.0.0.3
  291. # # Multiple gateways with a weight, this will balance traffic accordingly
  292. # - route: 192.168.87.0/24
  293. # via:
  294. # - gateway: 10.0.0.1
  295. # weight: 10
  296. # - gateway: 10.0.0.2
  297. # weight: 5
  298. #
  299. # NOTE: The nebula certificate of the "via" node(s) *MUST* have the "route" defined as a subnet in its certificate
  300. # `via`: single node or list of gateways to use for this route
  301. # `mtu`: will default to tun mtu if this option is not specified
  302. # `metric`: will default to 0 if this option is not specified
  303. # `install`: will default to true, controls whether this route is installed in the systems routing table.
  304. # This setting is reloadable.
  305. unsafe_routes:
  306. #- route: 172.16.1.0/24
  307. # via: 192.168.100.99
  308. # mtu: 1300
  309. # metric: 100
  310. # install: true
  311. # On Windows only, sets the network category of the nebula interface. Without this, Windows often
  312. # leaves the network as "Unidentified" and treats it as Public, which makes the host firewall more
  313. # restrictive than you usually want for an overlay between trusted peers. Valid values:
  314. # private - treat the nebula network as a private/trusted network (default)
  315. # public - treat it as a public/untrusted network
  316. # domain - treat it as a domain-authenticated network
  317. # unset - leave whatever Windows decided alone
  318. # Not reloadable.
  319. #network_category: private
  320. # On Windows only
  321. # When true, Nebula installs a WFP (Windows Filtering Platform) PERMIT filter scoped to the nebula adapter LUID.
  322. # WFP sits below Windows Defender Firewall, so this lets inbound traffic through regardless of WDF rules.
  323. # Filters are auto-removed when the adapter goes away.
  324. # See listen.windows_bypass_wdf for the matching control over inbound to nebula's outside UDP listener.
  325. # Default true; set to false to leave WDF in charge of inbound decisions on the nebula interface. Not reloadable.
  326. #windows_bypass_wdf: true
  327. # On linux only, set to true to manage unsafe routes directly on the system route table with gateway routes instead of
  328. # in nebula configuration files. Default false, not reloadable.
  329. #use_system_route_table: false
  330. # Buffer size for reading routes updates. 0 means default system buffer size. (/proc/sys/net/core/rmem_default).
  331. # If using massive routes updates, for example BGP, you may need to increase this value to avoid packet loss.
  332. # SO_RCVBUFFORCE is used to avoid having to raise the system wide max
  333. #use_system_route_table_buffer_size: 0
  334. # Configure logging level
  335. logging:
  336. # trace, debug, info, warn, or error. Default is info and is reloadable.
  337. # fatal and panic are accepted for backwards compatibility and map to error.
  338. #NOTE: Debug and trace modes can log remotely controlled/untrusted data which can quickly fill a disk in some
  339. # scenarios. Debug and trace logging are also CPU intensive and will decrease performance overall.
  340. # Only enable debug or trace logging while actively investigating an issue.
  341. level: info
  342. # json or text formats currently available. Default is text.
  343. format: text
  344. # Disable timestamp logging. Useful when output is redirected to a logging system that already adds timestamps. Default is false.
  345. #disable_timestamp: true
  346. # Timestamps use RFC3339Nano ("2006-01-02T15:04:05.999999999Z07:00") and are not configurable.
  347. # The stats section is reloadable. A HUP may change the backend, toggle stats
  348. # on or off, switch the listen/host address, or pick up new DNS for the
  349. # configured graphite host.
  350. #stats:
  351. #type: graphite
  352. #prefix: nebula
  353. #protocol: tcp
  354. #host: 127.0.0.1:9999
  355. #interval: 10s
  356. #type: prometheus
  357. #listen: 127.0.0.1:8080
  358. #path: /metrics
  359. #namespace: prometheusns
  360. #subsystem: nebula
  361. #interval: 10s
  362. # enables counter metrics for meta packets
  363. # e.g.: `messages.tx.handshake`
  364. # NOTE: `message.{tx,rx}.recv_error` is always emitted
  365. # Not reloadable.
  366. #message_metrics: false
  367. # enables detailed counter metrics for lighthouse packets
  368. # e.g.: `lighthouse.rx.HostQuery`
  369. # Not reloadable.
  370. #lighthouse_metrics: false
  371. # Handshake Manager Settings
  372. #handshakes:
  373. # Handshakes are sent to all known addresses at each interval with a linear backoff,
  374. # Wait try_interval after the 1st attempt, 2 * try_interval after the 2nd, etc, until the handshake is older than timeout
  375. # A 100ms interval with the default 10 retries will give a handshake 5.5 seconds to resolve before timing out
  376. #try_interval: 100ms
  377. #retries: 20
  378. # query_buffer is the size of the buffer channel for querying lighthouses, drops are recorded in the lighthouse.query.dropped metric.
  379. #query_buffer: 1024
  380. # trigger_buffer is the size of the buffer channel for quickly sending handshakes
  381. # after receiving the response for lighthouse queries
  382. #trigger_buffer: 64
  383. # pq enables hybrid handshakes: ML-KEM-1024 alongside the classical key exchange, so recorded traffic stays
  384. # secret against a future quantum computer, and authentication by the version 3 certificates' ML-KEM-1024 keys.
  385. # Both ends need a version 3 certificate in pki.cert; without one these settings are ignored with a warning, and
  386. # require is refused. These handshakes are too large for one packet and travel as fragments with forward error
  387. # correction.
  388. #pq:
  389. # initiate starts post-quantum handshakes. Attempts alternate between post-quantum and classical until one is
  390. # answered, so peers that do not support them still connect.
  391. #initiate: false
  392. # accept answers post-quantum handshakes from peers.
  393. #accept: false
  394. # require makes every handshake post-quantum: it implies initiate and accept, never offers a classical handshake
  395. # and refuses classical handshakes from peers. Only enable it once every host has a version 3 certificate.
  396. #require: false
  397. # sticky never falls back to a classical handshake with a peer that has completed a post-quantum one since
  398. # nebula started, which defeats an attacker who drops post-quantum handshakes to force a downgrade.
  399. #sticky: false
  400. # repair_delay is how long the forward error correction fragments trail the rest of a handshake message.
  401. #repair_delay: 10ms
  402. # Tunnel manager settings
  403. #tunnels:
  404. # drop_inactive controls whether inactive tunnels are maintained or dropped after the inactive_timeout period has
  405. # elapsed.
  406. # In general, it is a good idea to enable this setting. It will be enabled by default in a future release.
  407. # This setting is reloadable
  408. #drop_inactive: false
  409. # inactivity_timeout controls how long a tunnel MUST NOT see any inbound or outbound traffic before being considered
  410. # inactive and eligible to be dropped.
  411. # This setting is reloadable
  412. #inactivity_timeout: 10m
  413. # Nebula security group configuration
  414. firewall:
  415. # Action to take when a packet is not allowed by the firewall rules.
  416. # Can be one of:
  417. # `drop` (default): silently drop the packet.
  418. # `reject`: send a reject reply.
  419. # - For TCP, this will be a RST "Connection Reset" packet.
  420. # - For other protocols, this will be an ICMP "Destination unreachable: Communication administratively prohibited" packet.
  421. outbound_action: drop
  422. inbound_action: drop
  423. # THIS FLAG IS DEPRECATED AND WILL BE REMOVED IN A FUTURE RELEASE. (Defaults to false.)
  424. # This setting only affects nebula hosts exposing unsafe_routes. When set to false, each inbound rule must contain a
  425. # `local_cidr` if the intention is to allow traffic to flow to an unsafe route. When set to true, every firewall rule
  426. # will apply to all configured unsafe_routes regardless of the actual destination of the packet, unless `local_cidr`
  427. # is explicitly defined. This is usually not the desired behavior and should be avoided!
  428. #default_local_cidr_any: false
  429. conntrack:
  430. tcp_timeout: 12m
  431. udp_timeout: 3m
  432. default_timeout: 10m
  433. # The firewall is default deny. There is no way to write a deny rule.
  434. # Rules are comprised of a protocol, port, and one or more of host, group, or CIDR
  435. # Logical evaluation is roughly: port AND proto AND (ca_sha OR ca_name) AND (host OR group OR groups OR cidr) AND (local cidr)
  436. # - port: Takes `0` or `any` as any, a single number `80`, a range `200-901`, or `fragment` to match second and further fragments of fragmented packets (since there is no port available).
  437. # proto: `any`, `tcp`, `udp`, or `icmp`
  438. # a port specification is ignored if proto is `icmp`
  439. # host: `any` or a literal hostname, ie `test-host`
  440. # group: `any` or a literal group name, ie `default-group`
  441. # groups: Same as group but accepts a list of values. Multiple values are AND'd together and a certificate would have to contain all groups to pass
  442. # cidr: a remote CIDR, `0.0.0.0/0` is any ipv4 and `::/0` is any ipv6. `any` means any ip family and address.
  443. # local_cidr: a local CIDR, `0.0.0.0/0` is any ipv4 and `::/0` is any ipv6. `any` means any ip family and address.
  444. # This can be used to filter destinations when using unsafe_routes.
  445. # By default, this is set to only the VPN (overlay) networks assigned via the certificate networks field unless `default_local_cidr_any` is set to true.
  446. # If there are unsafe_routes present in this config file, `local_cidr` should be set appropriately for the intended us case.
  447. # ca_name: An issuing CA name
  448. # ca_sha: An issuing CA shasum
  449. outbound:
  450. # Allow all outbound traffic from this node
  451. - port: any
  452. proto: any
  453. host: any
  454. inbound:
  455. # Allow icmp between any nebula hosts
  456. - port: any
  457. proto: icmp
  458. host: any
  459. # Allow tcp/443 from any host with BOTH laptop and home group
  460. - port: 443
  461. proto: tcp
  462. groups:
  463. - laptop
  464. - home
  465. # Expose a subnet (unsafe route) to hosts with the group remote_client
  466. # This example assume you have a subnet of 192.168.100.1/24 or larger encoded in the certificate
  467. - port: 8080
  468. proto: tcp
  469. group: remote_client
  470. local_cidr: 192.168.100.1/24