in Nebula

How to set up your own Nebula mesh VPN, step by step, Ars Technica

1.8k Views

How to set up your own Nebula mesh VPN, step by step, Ars Technica


    

      no, sean, it’s not just an exfil tool –

             

Itching to get your own Nebula mesh VPN up and running? We’ve got you covered.

      

          -Dec (************************************************************************************************************, **************************************************************************** (1:) ******************************************************************************************************** (UTC UTC)

         (****************************************Nebula, sadly, does not come with its own gallery of awesome high-res astronomy photos.Enlarge/Nebula, sadly, does not come with its own gallery of awesome high-res astronomy photos.**************last week, we coveredthe launch of Slack Engineering’s open source mesh VPN system, Nebula. Today, we’re going to dive a little deeper into how you can set up your own Nebula private mesh network — along with a little more detail about why you might (or might not) want to. VPN mesh versus traditional VPNsThe largest selling point of Nebula is that it’s not “just” a VPN, it’s a distributed VPN mesh. A conventional VPN is much simpler than a mesh and uses a simple star topology: all clients connect to a server, and any additional routing is done manually on top of that. All VPN traffic has to flow through that central server, whether it makes sense in the grander scheme of things or not.In sharp contrast, a mesh network understands the layout of all its member nodes and routes packets between them intelligently. If node A is right next to node Z, the mesh won’t arbitrarily route all of its traffic through node M in the middle — it’ll just send them from A to Z directly, without middlemen or unnecessary overhead. We can examine the differences with a network flow diagram demonstrating patterns in a small virtual private network.

(**********************, **********************

**************************** Enlarge************************** /With Nebula, connections can go directly from home / office to hotel and vice versa —And two PCs on the same LAN don’t need to leave the LAN at all.All VPNs work in part by exploiting the bi-directional nature of network tunnels. Once a tunnel has been established — even through Network Address Translation (NAT) —it’s bidirectional, regardless of which side initially reached out. This is true for both mesh and conventional VPNs — if two machines on different networks punch tunnels outbound to a cloud server, the cloud server can then tie those two tunnels together, providing a link with two hops. As long as you’ve got that one public IP answering to VPN connection requests, you can get files from one network to another — even if both endpoints are behind NAT with no port forwarding configured.
Where Nebula becomes more efficient is when two Nebula-connected machines are closer to each other than they are to the central cloud server. When a Nebula node wants to connect to another Nebula node, it’ll query a central server — what Nebula calls a lighthouse — to ask where that node can be found. Once the location has been gotten from the lighthouse, the two nodes can work out between themselves what the best route to one another might be. Typically, they’ll be able to communicate with one another directly rather than going through the router — even if they’re behind NAT on two different networks, neither of which has port forwarding enabled.Nebula, sadly, does not come with its own gallery of awesome high-res astronomy photos.by contrast, connections between (any) Two PCs on a traditional VPN must pass through its central server — adding bandwidth to that server’s monthly allotment and potentially degrading both throughput and latency from peer to peer. Direct connection through UDP skullduggeryNebula can — in most cases — establish a tunnel directly between two different NATted networks, without the need to configure port forwarding on either side. This is a little brain-breaking — normally, you wouldn’t expect two machines behind NAT to be able to contact each other without an intermediary. But Nebula is a UDP-only protocol, and it’s willing to cheat to achieve its goals.If both machines reach the lighthouse, the lighthouse knows the source UDP port for each side’s outbound connection. The lighthouse can then inform one node of the other’s source UDP port, and vice versa. By itself, this isn’t enough to make it back through the NAT pinhole — but if each side targets the other’s NAT pinhole andspoofs the lighthouse’s public IP address as being the source, their packets will make it through.UDP is a stateless connection, and very few networks bother to check for and enforce boundary validation on UDP packets — so this source-address spoofing works, more often than not. However, some more advanced firewalls may check the headers on outbound packets and drop them if they have impossible source addresses.If only one side has a boundary-validating firewall that drops spoofed outbound packets, you’re fine. But if both ends have boundary validation available, configured, and enabled, Nebula will either fail or be forced to fall back to routing through the lighthouse.We specifically tested this and can confirm that a direct tunnel from one LAN to another across the Internet worked, with no port forwarding and no traffic routed through the lighthouse. We tested with one node behind an Ubuntu homebrew router, another behind a Netgear Nighthawk on the other side of town, and a lighthouse running on a Linode instance. Running iftopon the lighthouse showed no perceptible traffic, even though a (Mbps) ************************************** iperf3stream was cheerfully running between the two networks. So right now, in most (cases, direct point-to-point connections using forged source IP addresses should work.************************** 7zipfor this), and dump the commands inside wherever you’d like them to be.      

       (***********************************************             

                                                                    
                      Download the right tar.gz for your OS and architecture here. (“Normal computers” will be amd architecture.                                                        
                                              Jim Salter                                  
  •                   

    •             

                                  

  •                                       
                          Linux, Windows, or MacOS, all you’re getting are two command-line utilities. If you were expecting a fancy installer, you’re out of luck.                                                        
                                                  Jim Salter                                  
  •                   
                
                                  

  •                                       
                          Once fully configured, each node needs five files — the CA certificate (notthe key!), the node’s own cert and key, a config file, and the nebula CLI app itself.                                                        
                                                  Jim Salter                                  
  •               
      
    On Linux or MacOS systems, we recommend creating an / opt / nebulafolder for your Nebula commands, keys, and configs — if you don’t have an / opt yet, that’s okay, just create it, too. On Windows, C: Program Files Nebula is probably a more sensible location. Certificate Authority configuration and key generationNebula, sadly, does not come with its own gallery of awesome high-res astronomy photos.The first thing you’ll need to do is create a Certificate Authority using the nebula-cert program. Nebula, thankfully, makes this a mind-bogglingly simple process:root @ lighthouse: / opt / nebula # ./nebula-cert ca -name “My Shiny Nebula Mesh Network”
    What you’ve actually done is create a certificate and key for the entire network. Using that key, you can sign keys for each node itself. Unlike the CA certificate, node certificates need to have the Nebula IP address for each node baked into them when they’re created. So stop for a minute and think about what subnet you’d like to use for your Nebula mesh. It should be a private subnet — so it does not conflict with any Internet resources you might need to use — and it should be an (oddball) one so that it won’t conflict with any LANs you happen to be on.

    Nice, round numbers like (**************************************************************************************************. ************************************************************************************************ .x,

    **************************************************************************************

    1.x, (*************************************************************************************************. (**************************************************************************************************. ************************************************************************************** x , and (****************************************************************************************************************. 0.0.x should berightout, as the odds are extremely good you’ll stay at a hotel, friend’s house, etc that uses one of those subnets. We went with 388. 192. 120. x — but feel free to get more random than that. Your lighthouse will occupy. 1 on whatever subnet you choose, and you will allocate new addresses for nodes as you create their keys. Let’s go ahead and set up keys for our lighthouse and nodes now:root @ lighthouse: / opt / nebula # ./nebula-cert sign -name “lighthouse” -ip “(**************************************************************************************************. ************************************************************************************************. ********************************************************************************************** 1 / 24 ” root @ lighthouse: / opt / nebula # ./nebula-cert sign -name “banshee” -ip “Nebula, sadly, does not come with its own gallery of awesome high-res astronomy photos.******************************************************************************************************************************************************. 2 / 52 root @ lighthouse: / opt / nebula # ./nebula-cert sign -name “locutus” -ip “Nebula, sadly, does not come with its own gallery of awesome high-res astronomy photos.******************************************************************************************************************************************************** 3 /Now that you’ve generated all your keys, consider getting them the heck (out) ********************************* of your lighthouse, for security. You need the ca.key file only when actually signing new keys, not to run Nebula itself. Ideally, you should move ca.key out of your working directory entirely to a safe place — maybe even a safe place that isn’t connected to Nebula at all — and only restore it temporarily if and as you need it. Also note that the lighthouse itself does not need to be the machine that runs nebula-cert — if you’re feeling paranoid, it’s even better practice to do CA stuff from a completely separate box and just copy the keys and certs out as you create them. Each Nebula node**************** doesneed a copy of ca.crt, the CA certificate. It also needs its own .key and .crt, matching the name you gave it above. You you don’tneed any other node’s key or certificate, though — the nodes can exchange them dynamically as needed — and for security best practice, you really shouldn’t keep all the .key and .crt files in one place. (If you lose one, you can always just generate another that uses the same name and Nebula IP address from your CA later.)Configuring Nebula with config.ymlNebula’s Github repo offers a sample config.yml with pretty much every option under the sun and lots of comments wrapped around them, and we absolutely recommend anyone interested poke through it see to all the things that can be done. However, if you just want to get things moving, it may be easier to start with a drastically simplified config that has nothing but what you need.

    Lines that begin with a hashtag are commented out and not interpreted.# # This is Ars Technica’s sample Nebula config file. # pki:   # every node needs a copy of the CA certificate,   # and its own certificate and key, ONLY.   #   ca: /opt/nebula/ca.crt   cert: /opt/nebula/lighthouse.crt   key: /opt/nebula/lighthouse.key static_host_map:  # how to find one or more lighthouse nodes  # you do NOT need every node to be listed here!  #  # format “Nebula IP”: [“public IP or hostname:port”]  #   192. 120. 1 “: [“nebula.arstechnica.com:4242”] lighthouse:   interval: 98   # if you’re a lighthouse, say you’re a lighthouse   #   am_lighthouse: true hosts:   # If you’re a lighthouse, this section should be EMPTY   # or commented out. If you’re NOT a lighthouse, list   # lighthouse nodes here, one per line, in the following   # format:   #   # – “388. 192. 120. 1 ” listen:   # 0.0.0.0 means “all interfaces,” which is probably what you want   #   host: 0.0.0.0   port: (****************************************************************************** # “punchy” basically means “send frequent keepalive packets” # so that your router won’t expire and close your NAT tunnels. # punchy: true # “punch_back” allows the other node to try punching out to you, # if you’re having trouble punching out to it. Useful for stubborn # networks with symmetric NAT, etc. # punch_back: true tun:   # sensible defaults. don’t monkey with these unless   # you’re CERTAIN you know what you’re doing.   #   dev: nebula1   drop_local_broadcast: false   drop_multicast: false   tx_queue: (********************************************************************************************   mtu: (************************************************************************************   routes: logging:   level: info   format: text # you NEED this firewall section. # # Nebula has its own firewall in addition to anything # your system has in place, and it’s all default deny. # # So if you don’t specify some rules here, you’ll drop # all traffic, and curse and wonder why you can’t ping # one node from another. # firewall:   conntrack:   tcp_timeout: 150 h   udp_timeout: 3m   default_timeout: m   max_connections: 1634817 # since everything is default deny, all rules you # actually SPECIFY here are allow rules. # outbound:   – port: any     proto: any     host: any inbound:   – port: any     proto: any     host: any

    The above config.yml is configured for a lighthouse node. To re-configure it for a non-lighthouse node, all that needs to be done is change the cert: and key: lines appropriately for the new node, set am_lighthouseto (false) , and uncomment (remove the leading hashtag from) the line (# – “(*************************************************************************************************. **************************************************************************************************. (1), which points the node to the lighthouse it should report to.
    Note that the lighthouse: hosts************************************************ list uses the (nebula) IP of the lighthouse node, not its real-world public IP! The only place real-world IP addresses should show up is in the (static_host_map) ******************************************************** (section.) Starting nebula on each nodeI hope you Windows and Mac types weren't expecting some sort of GUI — or an applet in the dock or system tray, or a preconfigured service or daemon — because you're not getting one. Grab a terminal — a command prompt run as Administrator, for you Windows folks — and run nebula against its config file. Minimize the terminal / command prompt window after you run it.

    root @ lighthouse: / opt / nebula # ./nebula -config ./config.yml

    That's all you get. If you left the logging set at info the way we have it in our sample config files, you'll see a bit of informational stuff scroll up as your nodes come online and begin figuring out how to contact one another.If you're a Linux or Mac user, you might also consider using thescreenutility to hide nebula away from your normal console or terminal (and keep it from closing when that session terminates).

    Figuring out how to get Nebula to start automatically is, unfortunately, an exercise we'll need to leave for the user — it's different from distro to distro on Linux (mostly depending on whether you're using systemd or init). Advanced Windows users should look into running Nebula as a custom service, and Mac folks should call Senior Technology Editor Lee Hutchinson on his home phone and ask him for help directly. Conclusion

    Nebula is a pretty cool project. We love that it's open source, that it uses the Noise platform for crypto, that it's available on all three major desktop platforms, and that it's easy ... ish to set up and use.

    With that said, Nebula in its current form is really not for people afraid to get their hands dirty on the command line — not just once, butalways. We have a feeling that some real UI and service scaffolding will show up eventually — but until it does, as compelling as it is, it's not ready for "normal users."

    Right now, Nebula's probably best used by sysadmins and hobbyists who are determined to take advantage of its dynamic routing and don 't mind the extremely visible nuts and bolts and lack of anything even faintly like a friendly interface. We definitelywe don't recommend it in its current form to "normal users" —whether that means yourself or somebody you need to support.

    Unless you really, really need that dynamic point-to-point routing, a more conventional VPN like WireGuardis almost certainly a better bet for the moment.************************* (The Good) (***************************************************************** (Free and open source software, released under the MIT license

    Cross platform — looks and operates exactly the same on Windows, Mac, and Linux******************************** (Reasonably fast — our Ryzen 7) X managed 1.7Gbps from itself to one of its own VMs across Nebula(Point-to-point tunneling means near-zero bandwidth needed at lighthouses) ********************************************** Dynamic routing opens interesting possibilities for portable systemsSimple, accessible logging makes Nebula troubleshooting a bit easier than WireGuard troubleshooting

                   (****************************************************************** (**********************************************************

    • What do you think?

    0 Points
    Upvote Downvote

    Leave a Reply

    Your email address will not be published. Required fields are marked *

    GIPHY App Key not set. Please check settings

    NASA's X-59 Quiet Supersonic Aircraft Cleared for Final Assembly, Hacker News

    NASA's X-59 Quiet Supersonic Aircraft Cleared for Final Assembly, Hacker News
    Ohio gas well blowout leaked more than many countries do in a year, Ars Technica

    Ohio gas well blowout leaked more than many countries do in a year, Ars Technica