Code Monkey home page Code Monkey logo

build-vpn-server's Introduction

Build Your Own VPN Server

This project offers an automation tool to let you securely build your high speed Shadowsocks and/or Wireguard VPN servers in one minute ⚡ using Github.com Action. With a 💰 5 USD/month server from common cloud providers like Linode, Digital Ocean, and so on, you can stream 4K videos (Speed >= 25 Mpbs) in real time. Once you generate your VPN server(s) configurations, you can simply scan the QR-code on mobile and start using the service immediately.

Shortlink: http://git.io/buildVPN Read this in other languages: English, įŽ€äŊ“中文

How to use

In summary, you need to fork this repository, set up your server credentials via Github Secrets, then manually run the workflows/actions to build your VPN servers, then scan the resulting QR codes to configure your client side apps.

Detailed Instruction

  1. Prerequisite: have SSH access to a server with root permission. If you don't have a server yet, buying a $5/month instance from Linode or Digital Ocean would be an easy start.
  2. Sign in to GitHub
  3. Fork this repository, by click the Fork button in the top-right corner of the page ☝ī¸ . Fork this project
  4. In your forked/own repository, set up Github Encrypted Secrets for your server: HOST, USERNAME, either PASSWORD or KEY, and optionally PORT if your port number is not default. Set your SSH credentials via Github Secrets
  5. On your repository navigation, click Actions, then click Build Shadowsocks Server or Build Wireguard Server, then click Run workflow (from main). Trigger a build VPN workflow Shadowsocks builds have vanilla Shadowsocks and Shadowsocks over kcptun (optimized for real time). Either Shadowocks over kcptun or Wireguard is very fast, you can build both for redundency. Please see more additional documentation for use case comparsion and configurations.
  6. The build should take one minute, once it's finished, check the result, under Configure your client step, there are your configurations and QR-code Configure your client
  7. â€ŧī¸ If your repository is public, Delete workflow run immediately after you successfully configure your client side app. Because, even though your secrets are masked in the log output, the generated QR-Code can reveal your secrets. Failing to do so can result in other people using your VPN without your permission. Delete workflow run, more doc

Client Side App configuration

Please see Client side app configurations.

Updates

This project/tool is probably quite different from most apps you have used. You don't have to download anything or run the code in your computer. Once you forked this project as the instruction says, you can keep your copy updated by pull from upstream if you are familiar with Git. Or you can simply delete your forked repository then start over.

Support & Contributing

You can open bug report, feature request or support request on this main project issues. Also, please read Contributing to Open Source Guides

build-vpn-server's People

Contributors

certaintls avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤ī¸ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.