Giter Club home page Giter Club logo

docker_ssh_vpn's Introduction

Multi-Platform Debian Docker Image for VPN Services

ci

This repository contains the source code for a multi-platform Debian Docker image designed for deployment in AWS environments, specifically tailored for ECS or any similar AWS service. But you should be able to deploy this to any platform supporting container services. This Docker image facilitates the creation of an OpenVPN server, built-in SSH access & automatic IP address updating (for AWS environments only). Apart from NET_ADMIN capabilities, the script (or the docker file) doesn't depend on any privileged stuff being available. The only requirement, is that the container should share the same network namespace as the host, or have some way of interacting with the internet, since you can't enable ipv4 forwarding.

Features

  • Built-in SSH Access: Enables logging into the server instance directly, providing ease of management and troubleshooting, even in serverless deployments.
  • Automatic IP Address Update: Integrated script to update the server's IP address in AWS Route 53 automatically, ensuring the service remains accessible even after on-demand restarts or scaling operations.
  • OpenVPN Server: Pre-configured OpenVPN server for secure, encrypted VPN tunnels.

Prerequisites

Before deploying this Docker image, ensure you have the following:

  • Docker installed on your local machine or CI/CD environment.
  • Access to an AWS account with permissions to manage ECS, Route 53, and other relevant services.

Deployment

  • TODO

Usage

  • Build the image, or you use the pre-built image from docker_ssh_openvpn
  • Deploy and run the image
  • SSH into your system, and copy the /root/client.ovpn file to your local
  • Done!

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs, feature requests, or improvements.

License

This project is open-sourced under the MIT License.

Acknowledgments

  • Thanks to the Debian, Docker & OpenVPN communities for their invaluable resources and documentation.
  • Thanks to Nyr for the wonderful openvpn installation script

docker_ssh_vpn's People

Contributors

gliesefire 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.