{"id":17707667,"url":"https://github.com/wdzeng/proxy-over-vpn","last_synced_at":"2025-03-31T06:26:03.616Z","repository":{"id":105360646,"uuid":"501968913","full_name":"wdzeng/proxy-over-vpn","owner":"wdzeng","description":"Run forward proxy server over VPN.","archived":false,"fork":false,"pushed_at":"2022-06-12T18:50:41.000Z","size":18,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-06T10:53:11.605Z","etag":null,"topics":["forward-proxy","nginx","openvpn","proxy","vpn"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wdzeng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-10T08:49:17.000Z","updated_at":"2022-06-26T13:27:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"eee08b4e-9d3c-49e2-9106-a4edc5d0b613","html_url":"https://github.com/wdzeng/proxy-over-vpn","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fproxy-over-vpn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fproxy-over-vpn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fproxy-over-vpn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fproxy-over-vpn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wdzeng","download_url":"https://codeload.github.com/wdzeng/proxy-over-vpn/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246425618,"owners_count":20775171,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["forward-proxy","nginx","openvpn","proxy","vpn"],"created_at":"2024-10-25T01:06:12.050Z","updated_at":"2025-03-31T06:26:03.587Z","avatar_url":"https://github.com/wdzeng.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Proxy over VPN\n\n[![github](https://badgen.net/badge/icon/github?icon=github\u0026label=\u0026color=black)](https://github.com/wdzeng/proxy-over-vpn/)\n[![docker](https://badgen.net/badge/icon/docker?icon=docker\u0026label=)](https://hub.docker.com/repository/docker/hyperbola/proxy-over-vpn)\n[![release](https://badgen.net/github/release/wdzeng/proxy-over-vpn?color=red)](https://github.com/wdzeng/proxy-over-vpn/releases/latest)\n\n![MEME](res/meme.webp)\n\nRun HTTP forward proxy server over VPN in docker container.\n\n\u003e **Warning**  \n\u003e Since a root container is required, you should not use podman.\n\n\u003e **Warning**  \n\u003e This project aims at HTTP proxy only.\n\nThis image contains [NGINX](https://www.nginx.com/) server with [ngx_http_proxy_connect_module module](https://github.com/chobits/ngx_http_proxy_connect_module) and [OpenVPN](https://openvpn.net/). User traffics first arrive the forward proxy server, which then forward them over the VPN to the world.\n\n## Usage\n\nPrepare an .ovpn file for OpenVPN config.\n\nCommon usage:\n\n```sh\ndocker run [-it] \\\n    --cap-add NET_ADMIN \\\n    -p \u003cexposed-port\u003e:3128 \\\n    -v /path/to/ovpn:/config.ovpn\n    hyperbola/proxy-over-vpn:1\n```\n\n- NGINX server acts as forward proxy server which exposes port on 3128, and therefore you need to set `-p \u003cexposed-port\u003e:3128` to forward the port.\n- OpenVPN requires the `NET_ADMIN` capability to work so you need to set `--cap-add NET_ADMIN` flag.\n- OpenVPN client reads the config at /config.ovpn so you need to mount that file with `-v /path/to/ovpn:/config.ovpn`.\n\n## Logs\n\nBy default, logs of nginx server are output to stdout and stderr. Mount to /var/log/nginx/access.log and /var/log/nginx/error.log to collect logs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwdzeng%2Fproxy-over-vpn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwdzeng%2Fproxy-over-vpn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwdzeng%2Fproxy-over-vpn/lists"}