Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/PHLAK/docker-openvpn
Docker image for OpenVPN client/server.
https://github.com/PHLAK/docker-openvpn
alpine-linux docker docker-image openvpn vpn vpn-client vpn-server
Last synced: about 1 month ago
JSON representation
Docker image for OpenVPN client/server.
- Host: GitHub
- URL: https://github.com/PHLAK/docker-openvpn
- Owner: PHLAK
- License: mit
- Created: 2016-01-04T07:00:20.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-04-01T19:56:42.000Z (over 1 year ago)
- Last Synced: 2024-10-31T14:36:30.015Z (about 1 month ago)
- Topics: alpine-linux, docker, docker-image, openvpn, vpn, vpn-client, vpn-server
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/phlak/openvpn/
- Size: 51.8 KB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - PHLAK/docker-openvpn - Docker image for OpenVPN client/server. (docker)
README
docker-openvpn
==============
Docker image for OpenVPN client/server.
---
This container can run as an OpenVPN server or as an OpenVPN client and provide a VPN tunnel for
other containers to utilize via Docker's shared networking stack (i.e. `--net container:[NAME]`).
Running the Container
---------------------
Place your OpenVPN client/server configuration file in a directory on your host file system
(i.e. `/srv/openvpn`) with the name `openvpn.conf`. You should also place your client/server certs,
keys and any additional files required in this directory.
#### Running as an OpenVPN server
Run the OpenVPN container and map your local config directory (`/srv/openvpn`) to the container
config directory (`/vol/config`) and map ports to your host OS:
docker run -d -v /srv/openvpn:/vol/config -p 443:443 -p 943:943 -p 1194:1194/udp --privileged --name openvpn-server phlak/openvpn --server [NETWORK] [NETMASK]
#### Running as an OpenVPN client
Run the OpenVPN container and map your local config directory (`/srv/openvpn`) to the container
config directory (`/vol/config`):
docker run -d -v /srv/openvpn:/vol/config --privileged --name openvpn-client phlak/openvpn
Now you can start up another container with a shared network stack to the OpenVPN container:
docker run -d --net container:openvpn-client --name container-name alpine
This container will now be reliant on the OpenVPN container's network stack for network access.
#### Optional 'docker run' Arguments
`-p 1234:1234` - Map a port on the host OS to the OpenVPN container. When running as a client this
will pass ports through to containers that share the OpenVPN container's network
stack (i.e. When ran with the `--net container:openvpn-client` parameter).
`--restart always` - Always restart the container regardless of the exit status. See the Docker
[restart policies](https://goo.gl/OI87rA) for additional details.
Troubleshooting
---------------
When running a client container, if you are having trouble making a connection and `docker logs`
shows `Initialization Sequence Completed` without indicatiing any problems try manually setting your
container's DNS servers by adding `--dns 1.1.1.1 --dns 1.0.0.1` to your run command. Once your
container is running check you DNS name servers with:
docker exec transmission-vpn cat /etc/resolv.conf
For general help and support join our [GitHub Discussions](https://github.com/PHLAK/docker-openvpn/discussions) or reach out on [Twitter](https://twitter.com/PHLAK).
Please report bugs to the [GitHub Issue Tracker](https://github.com/PHLAK/docker-openvpn/issues).
Copyright
---------
This project is licensed under the [MIT License](https://github.com/PHLAK/docker-openvpn/blob/master/LICENSE).