{"id":17684657,"url":"https://github.com/tarampampam/3proxy-docker","last_synced_at":"2025-04-04T16:14:40.204Z","repository":{"id":38108289,"uuid":"278665125","full_name":"tarampampam/3proxy-docker","owner":"tarampampam","description":"🥷 Docker image with 3proxy - Tiny free proxy server","archived":false,"fork":false,"pushed_at":"2025-03-14T10:02:18.000Z","size":174,"stargazers_count":177,"open_issues_count":0,"forks_count":46,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T15:07:59.718Z","etag":null,"topics":["3proxy","docker","docker-image"],"latest_commit_sha":null,"homepage":"https://ghcr.io/tarampampam/3proxy","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tarampampam.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-10T15:10:59.000Z","updated_at":"2025-03-27T14:51:54.000Z","dependencies_parsed_at":"2023-10-02T08:11:37.388Z","dependency_job_id":"8727545f-4e4f-4722-a130-6971f2208fc2","html_url":"https://github.com/tarampampam/3proxy-docker","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2F3proxy-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2F3proxy-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2F3proxy-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2F3proxy-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tarampampam","download_url":"https://codeload.github.com/tarampampam/3proxy-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208147,"owners_count":20901570,"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":["3proxy","docker","docker-image"],"created_at":"2024-10-24T10:24:36.498Z","updated_at":"2025-04-04T16:14:40.184Z","avatar_url":"https://github.com/tarampampam.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/tarampampam/3proxy-docker#readme\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://socialify.git.ci/tarampampam/3proxy-docker/image?description=1\u0026font=Raleway\u0026forks=1\u0026issues=1\u0026logo=https%3A%2F%2Fgithub.com%2Fuser-attachments%2Fassets%2F023186cf-b153-459c-8417-038fd87a2065\u0026owner=1\u0026pulls=1\u0026pattern=Solid\u0026stargazers=1\u0026theme=Dark\"\u003e\n      \u003cimg align=\"center\" src=\"https://socialify.git.ci/tarampampam/3proxy-docker/image?description=1\u0026font=Raleway\u0026forks=1\u0026issues=1\u0026logo=https%3A%2F%2Fgithub.com%2Fuser-attachments%2Fassets%2F023186cf-b153-459c-8417-038fd87a2065\u0026owner=1\u0026pulls=1\u0026pattern=Solid\u0026stargazers=1\u0026theme=Light\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/tarampampam/3proxy-docker/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/tarampampam/3proxy-docker/tests.yml?branch=master\u0026maxAge=30\u0026label=tests\u0026logo=github\u0026style=flat-square\" alt=\"\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/tarampampam/3proxy-docker/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/tarampampam/3proxy-docker/release.yml?maxAge=30\u0026label=release\u0026logo=github\u0026style=flat-square\" alt=\"\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/tarampampam/3proxy\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/tarampampam/3proxy.svg?maxAge=30\u0026label=pulls\u0026logo=docker\u0026logoColor=white\u0026style=flat-square\" alt=\"\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/tarampampam/3proxy\"\u003e\u003cimg src=\"https://img.shields.io/docker/image-size/tarampampam/3proxy/latest?maxAge=30\u0026label=size\u0026logo=docker\u0026logoColor=white\u0026style=flat-square\" alt=\"\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/tarampampam/3proxy-docker/blob/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/tarampampam/3proxy-docker.svg?maxAge=30\u0026style=flat-square\" alt=\"\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Docker image with [3proxy][link_3proxy]\n\n3proxy is a powerful and lightweight proxy server. This image includes the stable version and can be easily\nconfigured using environment variables. By default, it operates with anonymous proxy settings to hide client\ninformation and logs activity in JSON format.\n\n\u003e Page on `hub.docker.com` can be [found here][link_docker_hub].\n\nTCP ports:\n\n| Port number | Description                                             |\n|-------------|---------------------------------------------------------|\n| `3128`      | [HTTP proxy](https://3proxy.org/doc/man8/proxy.8.html)  |\n| `1080`      | [SOCKS proxy](https://3proxy.org/doc/man8/socks.8.html) |\n\n## Supported tags\n\n| Registry                               | Image                        |\n|----------------------------------------|------------------------------|\n| [GitHub Container Registry][link_ghcr] | `ghcr.io/tarampampam/3proxy` |\n| [Docker Hub][link_docker_hub] (mirror) | `tarampampam/3proxy`         |\n\n\u003e [!NOTE]\n\u003e It’s recommended to avoid using the `latest` tag, as **major** upgrades may include breaking changes.\n\u003e Instead, use specific tags in `X.Y.Z` format for version consistency.\n\nAll supported image tags can be [found here][link_docker_tags].\n\n\u003e Starting with version 1.8.2, the `arm64` architecture is supported (in addition to `amd64`):\n\n```shell\ndocker run --rm mplatform/mquery ghcr.io/tarampampam/3proxy:1.8.2\n\nImage: ghcr.io/tarampampam/3proxy:1.8.2\n * Manifest List: Yes (Image type: application/vnd.docker.distribution.manifest.list.v2+json)\n * Supported platforms:\n   - linux/amd64\n   - linux/arm64\n```\n\n## Supported Environment Variables\n\n| Variable Name        | Description                                                                                                           | Example                           |\n|----------------------|-----------------------------------------------------------------------------------------------------------------------|-----------------------------------|\n| `PROXY_LOGIN`        | Authorization login (empty by default)                                                                                | `username`                        |\n| `PROXY_PASSWORD`     | Authorization password (empty by default)                                                                             | `password`                        |\n| `EXTRA_ACCOUNTS`     | Additional proxy users (JSON object format)                                                                           | `{\"evil\":\"live\", \"guest\":\"pass\"}` |\n| `PRIMARY_RESOLVER`   | Primary DNS resolver (`1.0.0.1` by default)                                                                           | `8.8.8.8:5353/tcp`                |\n| `SECONDARY_RESOLVER` | Secondary DNS resolver (`8.8.4.4` by default)                                                                         | `2001:4860:4860::8844`            |\n| `MAX_CONNECTIONS`    | Maximum number of connections (`1024` by default)                                                                     | `2056`                            |\n| `PROXY_PORT`         | HTTP proxy port (`3128` by default)                                                                                   | `8080`                            |\n| `SOCKS_PORT`         | SOCKS proxy port (`1080` by default)                                                                                  | `8888`                            |\n| `EXTRA_CONFIG`       | Additional 3proxy configuration (appended to the **end** of the config file, but before `proxy` and `flush`)          | `# line 1\\n# line 2`              |\n| `LOG_OUTPUT`         | Path for log output (`/dev/stdout` by default; set to `/dev/null` to disable logging)                                 | `/tmp/3proxy.log`                 |\n\n## Helm Chart\n\nTo install it on Kubernetes (K8s), please use the Helm chart from [ArtifactHUB][artifact-hub].\n\n[artifact-hub]:https://artifacthub.io/packages/helm/proxy-3proxy/proxy-3proxy\n\n## How to Use This Image\n\nExample usage:\n\n```bash\ndocker run --rm -d \\\n  -p \"3128:3128/tcp\" \\\n  -p \"1080:1080/tcp\" \\\n  ghcr.io/tarampampam/3proxy:1\n```\n\nWith authentication and custom resolver settings:\n\n```bash\ndocker run --rm -d \\\n  -p \"3128:3128/tcp\" \\\n  -p \"1080:1080/tcp\" \\\n  -e \"PROXY_LOGIN=evil\" \\\n  -e \"PROXY_PASSWORD=live\" \\\n  -e \"PRIMARY_RESOLVER=2001:4860:4860::8888\" \\\n  ghcr.io/tarampampam/3proxy:1\n```\n\nDocker compose example:\n\n```yaml\nservices:\n  3proxy:\n    image: ghcr.io/tarampampam/3proxy:1\n    environment:\n      PROXY_LOGIN: evil\n      PROXY_PASSWORD: live\n      MAX_CONNECTIONS: 10000\n      PROXY_PORT: 8000\n      SOCKS_PORT: 8001\n      PRIMARY_RESOLVER: 77.88.8.8\n      SECONDARY_RESOLVER: 8.8.8.8\n    ports:\n      - '8000:8000/tcp'\n      - '8001:8001/tcp'\n```\n\n## Releasing\n\nPublishing a new version is straightforward:\n\n1. Make the necessary changes in this repository.\n2. \"Publish\" a new release on the repository's releases page.\n\nDocker images will be automatically built and published.\n\n\u003e Note: The `latest` tag will be overwritten in both registries when a new release is published.\n\n## Support\n\n[![Issues][badge_issues]][link_issues]\n[![Issues][badge_pulls]][link_pulls]\n\nIf you encounter any issues, please [open an issue][link_create_issue] in this repository.\n\n## License\n\nThis project is licensed under the WTFPL. Use it freely and enjoy!\n\n[badge_issues]:https://img.shields.io/github/issues/tarampampam/3proxy-docker.svg?style=flat-square\u0026maxAge=180\n[badge_pulls]:https://img.shields.io/github/issues-pr/tarampampam/3proxy-docker.svg?style=flat-square\u0026maxAge=180\n[link_issues]:https://github.com/tarampampam/3proxy-docker/issues\n[link_pulls]:https://github.com/tarampampam/3proxy-docker/pulls\n[link_create_issue]:https://github.com/tarampampam/3proxy-docker/issues/new\n[link_docker_tags]:https://hub.docker.com/r/tarampampam/3proxy/tags\n[link_docker_hub]:https://hub.docker.com/r/tarampampam/3proxy/\n[link_ghcr]:https://github.com/tarampampam/3proxy-docker/pkgs/container/3proxy\n[link_3proxy]:https://github.com/3proxy/3proxy\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarampampam%2F3proxy-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftarampampam%2F3proxy-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarampampam%2F3proxy-docker/lists"}