BranchesTags

Repository files navigation

n3n

n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.

In order to start using n3n, two elements are required:

  • A supernode: it allows edge nodes to announce and discover other nodes. It must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks

A virtual network shared between multiple edge nodes in n3n is called a community. A single supernode can relay multiple communities and a single computer can be part of multiple communities at the same time (by running multiple edge daemons). An encryption key can be used by the edge nodes to encrypt the packets within their community.

n3n tries to establish a direct peer-to-peer connection via udp between the edge nodes when possible. When this is not possible (usually due to special NAT devices), the supernode is also used to relay the packets.

n3n was originally based on an older n2n project and hopes to keep protocol compatiblilty with that.

Note that some distributions have very old versions of n2n packaged that are incompatible with the protocol used by n3n. At the least, Debian has a n2n version 1.3.1 which uses a protocol from 2008 and has not been compatible with the stable releases of n2n for many years - thus will definitely not interoperate with n3n)

License

  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body that can take ownership of the code and/or change the licensing.

Quick Start

For Debian, Ubuntu or similar dpkg based systems:

  • Download the package from the latest stable release.

  • Install the package

  • Create a config file - /etc/n3n/mynetwork.conf containing

    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork

  • Check the connection: sudo n3nctl -s mynetwork supernodes

  • List other nodes found: sudo n3nctl -s mynetwork edges

IMPORTANT: It is strongly advised to choose a custom community name (the community.name option) and a secret encryption key (the community.key option) in order to prevent other users from connecting to your computer.

It is also suggested that you setup your own supernode

See Also

Contribution

You can contribute to n3n in various ways:

  • Update an open issue or create a new one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements

(C) 2007-22 - ntop.org and contributors Copyright (C) 2023-25 Hamish Coleman

About

Peer to Peer VPN

n3n.dev

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
n3n
n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.
In order to start using n3n, two elements are required:
  • A supernode: it allows edge nodes to announce and discover other nodes. It
must have a port publicly accessible on internet.
  • edge nodes: the nodes which will be a part of the virtual networks
A virtual network shared between multiple edge nodes in n3n is called a
community. A single supernode can relay multiple communities and a single
computer can be part of multiple communities at the same time (by running
multiple edge daemons). An encryption key can be used by the edge nodes to
encrypt the packets within their community.
n3n tries to establish a direct peer-to-peer connection via udp between the
edge nodes when possible. When this is not possible (usually due to special NAT
devices), the supernode is also used to relay the packets.
n3n was originally based on an older n2n project and hopes to keep protocol
compatiblilty with that.
Note that some distributions have very old versions of n2n packaged that are
incompatible with the protocol used by n3n. At the least, Debian has a n2n
version 1.3.1 which uses a protocol from 2008 and has not been compatible with
the stable releases of n2n for many years - thus will definitely not
interoperate with n3n)
License
  • Any new self-contained tools or modules are licensed GPL-2.0-only.
  • Existing code is licensed GPL-3-only.
  • There are multiple distinct copyright holders throughout the codebase.
  • There is no Contributor Licence Agreement and thus there is no single body
that can take ownership of the code and/or change the licensing.
Quick Start
For Debian, Ubuntu or similar dpkg based systems:
  • Download the package from the latest stable release.
  • Install the package
  • Create a config file - /etc/n3n/mynetwork.conf containing
    [community]
name=mynetwork
key=mypassword
supernode=supernode.ntop.org:7777

  • Start the service: sudo systemctl start n3n-edge@mynetwork
  • Check the connection: sudo n3nctl -s mynetwork supernodes
  • List other nodes found: sudo n3nctl -s mynetwork edges
IMPORTANT: It is strongly advised to choose a custom community name (the
community.name option) and a secret encryption key (the community.key
option) in order to prevent other users from connecting to your computer.
It is also suggested that you setup your own supernode
See Also
Contribution
You can contribute to n3n in various ways:
  • Update an open issue or create a new
one with detailed information
  • Propose new features
  • Improve the documentation
  • Provide pull requests with enhancements
(C) 2007-22 - ntop.org and contributors
Copyright (C) 2023-25 Hamish Coleman
About
Peer to Peer VPN
n3n.dev
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
1 fork
Report repository
Releases
Packages
Contributors
Languages