Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mysteriumnetwork/node
Mysterium Network Node - official implementation of distributed VPN network (dVPN) protocol
https://github.com/mysteriumnetwork/node
blockchain distributed distributed-systems golang networking vpn vpn-client vpn-server vpnfree
Last synced: 20 days ago
JSON representation
Mysterium Network Node - official implementation of distributed VPN network (dVPN) protocol
- Host: GitHub
- URL: https://github.com/mysteriumnetwork/node
- Owner: mysteriumnetwork
- License: gpl-3.0
- Created: 2017-01-26T00:43:08.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-04-22T11:06:13.000Z (7 months ago)
- Last Synced: 2024-04-22T13:02:19.211Z (7 months ago)
- Topics: blockchain, distributed, distributed-systems, golang, networking, vpn, vpn-client, vpn-server, vpnfree
- Language: Go
- Homepage: https://mysterium.network
- Size: 22.8 MB
- Stars: 1,078
- Watchers: 78
- Forks: 304
- Open Issues: 111
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome - node - Mysterium Node - VPN server and client for Mysterium Network (Go)
- best-of-crypto - GitHub - 2% open · ⏱️ 16.05.2024): (Others)
- awesome-hacking-lists - mysteriumnetwork/node - Mysterium Network Node - official implementation of distributed VPN network (dVPN) protocol (Go)
- awesome-network-stuff - **581**星 - VPN server and client for decentralized Mysterium Network (<a id="d62a971d37c69db9f3b9187318c3921a"></a>工具 / <a id="8ea8f890cf767c3801b5e7951fca3570"></a>公网访问局域网)
README
# Mysterium Node - decentralized VPN built on blockchain
[](https://goreportcard.com/report/github.com/mysteriumnetwork/node)
[](https://gitlab.com/mysteriumnetwork/node/pipelines)
[](https://codecov.io/gh/mysteriumnetwork/node)
[](http://godoc.org/github.com/mysteriumnetwork/node)
Cross-platform software to run a node in Mysterium Network. It contains Mysterium server (node),
client API (tequila API) and client-cli (console client) for Mysterium Network.
Currently node supports WireGuard as its underlying VPN transport.
## Getting Started
- [Homepage](https://mysterium.network)
- [Whitepaper](https://mysterium.network/whitepaper.pdf)
- [Latest release](https://github.com/mysteriumnetwork/node/releases/latest)
- [Snapshot builds](https://github.com/mysteriumnetwork/node-builds/releases) - bleeding edge, use at your own risk
- [Documentation](https://docs.mysterium.network/)
- [Help Center](https://help.mystnodes.com/)
- [Installation guide](https://help.mystnodes.com/en/?q=installation)
## Installation options
### Debian / Ubuntu / Raspbian
Install latest stable release:
```bash
sudo -E bash -c "$(curl -s https://raw.githubusercontent.com/mysteriumnetwork/node/master/install.sh)"
```
Or install latest snapshot (development build):
```bash
SNAPSHOT=true sudo -E bash -c "$(curl -s https://raw.githubusercontent.com/mysteriumnetwork/node/master/install.sh)"
```
Service logs:
```bash
sudo journalctl -u mysterium-node.service
```
Service status:
```bash
sudo systemctl status mysterium-node.service
```
Installation script tested on these OSes so far: _Raspbian 10_, _Debian 9_, _Debian 10_, _Ubuntu 18.04_ and _Ubuntu 20.04_.
### Docker
Our docker images can be found in [Docker hub](https://hub.docker.com/r/mysteriumnetwork/myst).
To run a node in a docker container you will need [docker](https://www.docker.com/). On Linux, to manage docker as a non-root user (execute commands without `sudo`), follow [postinstall guide](https://help.mystnodes.com/en/articles/3777670-running-a-node-as-docker-image-on-linux-host/).
You should be able to run a node on any OS that supports docker. We have tested it on these OSes so far:
- Debian 9
- Debian 10
- Ubuntu 18.04
- Ubuntu 20.04
- Ubuntu 22.04
- Yocto Linux (BalenaOS)
Run node:
```bash
docker run \
--cap-add NET_ADMIN \
--net host \
--name myst -d \
mysteriumnetwork/myst service --agreed-terms-and-conditions
```
Access service logs:
```bash
docker logs -f myst
```
### Further information
More installation options are described in the [installation guides](https://help.mystnodes.com/en/?q=installation).
For possible issues while running a node refer to our [Troubleshooting guides](https://help.mystnodes.com/en/collections/1992526-troubleshooting-mystnodes-help-center).
## Built With
* [go](https://golang.org/) - The Go Programming Language
* [gitlab](https://docs.gitlab.com/ce/ci/) - GitLab CI/CD
* [docker](https://www.docker.com/what-docker) - Containerize applications
* [openvpn](https://openvpn.net) - Solid VPN solution
* [wireguard](https://www.wireguard.com/) - Extremely simple yet fast and modern VPN
* [geth](https://geth.ethereum.org/) - Official Go implementation of the Ethereum protocol
## Contributing
For a detailed guide, please visit our [developer docs](https://docs.mysterium.network/for-developers/node-development).
## Core contributors
* **Valdas Petrulis** - *Lead developer, go evangelist, node bootstrapper* - [Waldz](https://github.com/Waldz)
* **Tadas Valiukas** - *Senior developer, experienced bug maker* - [tadovas](https://github.com/tadovas)
* **Donatas Kučinskas** - *Senior developer, clean code savvy* - [donce](https://github.com/donce)
* **Antanas Masevičius** - *Network engineer / developer, net guru* - [zolia](https://github.com/zolia)
* **Ignas Bernotas** - *Senior developer, open source enthusiast* - [ignasbernotas](https://github.com/ignasbernotas)
* **Dmitry Shihovtsev** - *Senior developer, devops ninja* - [soffokl](https://github.com/soffokl)
* **Viktoras Kuznecovas** - *Senior developer, supersonic typing specialist* [vkuznecovas](https://github.com/vkuznecovas)
* **Tadas Krivickas** - *Senior fullstack engineer, CI boss, refactoring fairy* [tadaskay](https://github.com/tadaskay)
* **Jaro Šatkevič** - *Senior developer, micro-payments researcher, crypto maniac* [chompomonim](https://github.com/chompomonim)
* **Andzej Maciusovič** - *Senior developer, disciplined world changer* [anjmao](https://github.com/anjmao)
* **Mantas Domaševičius** - *Senior fullstack engineer, always ready for pair programming* [mdomasevicius](https://github.com/mdomasevicius)
* **Tomas Mikalauskas** - *Backend developer, golang lover, payment guru* [tomasmik](https://github.com/tomasmik)
* **Vlad Iarmak** - *Protocol architect, networking guru, inexhaustible RFC writer* [Snawoot](https://github.com/Snawoot)
See also full list of [contributors](https://github.com/mysteriumnetwork/node/contributors) who participated in this project.
## License
This project is licensed under the terms of the GNU General Public License v3.0 (see [details](./LICENSE)).