{"id":24805262,"url":"https://github.com/ixoncloud/edge-app-microsocks","last_synced_at":"2026-03-09T20:03:50.102Z","repository":{"id":273537858,"uuid":"920049177","full_name":"ixoncloud/edge-app-microsocks","owner":"ixoncloud","description":"Edge App - MicroSocks","archived":false,"fork":false,"pushed_at":"2025-05-21T11:58:38.000Z","size":151,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-10T23:10:47.207Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":false,"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/ixoncloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2025-01-21T13:29:57.000Z","updated_at":"2025-05-21T11:58:41.000Z","dependencies_parsed_at":"2025-06-17T09:39:44.225Z","dependency_job_id":"c3971c25-93c6-4a14-9df0-d456610ba17c","html_url":"https://github.com/ixoncloud/edge-app-microsocks","commit_stats":null,"previous_names":["ixoncloud/edge-app-microsocks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ixoncloud/edge-app-microsocks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fedge-app-microsocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fedge-app-microsocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fedge-app-microsocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fedge-app-microsocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ixoncloud","download_url":"https://codeload.github.com/ixoncloud/edge-app-microsocks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fedge-app-microsocks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30310007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T17:35:44.120Z","status":"ssl_error","status_checked_at":"2026-03-09T17:35:43.707Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2025-01-30T07:17:32.328Z","updated_at":"2026-03-09T20:03:50.073Z","avatar_url":"https://github.com/ixoncloud.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Edge App - MicroSocks\n\nThe Edge App - MicroSocks provides a simple and efficient way to run a SOCKS5 proxy on IXON SecureEdge Pro, enabling secure and flexible network routing for various use cases. By leveraging the heywoodlh/microsocks Docker container, the Edge App allows you to quickly deploy a proxy with authentication, ensuring adaptable and secure connectivity tailored to your needs.\n\nKey Features:\n\n1. Quick Deployment: Easily set up and run a SOCKS5 proxy in seconds.\n2. Authentication Options: Support for username/password to restrict access when needed.\n3. Efficient Design: Lightweight and optimized for secure routing on SecureEdge Pro hardware\n\n## Steps to Deploy\n\n### Prerequisites\n\nEnsure your environment is properly set up by following this guide: [Running custom Docker applications on the SecureEdge Pro](https://support.ixon.cloud/hc/en-us/articles/14231117531420-Running-custom-Docker-applications-on-the-SecureEdge-Pro).\n\n### 1. Download and adjust to your SecureEdge Pro\n\nDownload the code of this project and change the IP address in the following files to the LAN IP address of your SecureEge Pro:\n\n- buildkitd-secure-edge-pro.toml\n- build_and_push_containers.sh\n- build_and_push_containers.cmd\n\n### 2. Build and Push the Container\n\nEnsure you have the correct builder in use:\n\nFor Unix-based systems:\n\n```bash\n./setup-buildx-env.sh\n```\n\nFor Windows:\n\n```cmd\nsetup-buildx-env.cmd\n```\n\nRun the script to build and push the container to the SecureEdge Pro:\n\nFor Unix-based systems:\n\n```bash\n./build_and_push_containers.sh\n```\n\nFor Windows:\n\n```cmd\nbuild_and_push_containers.cmd\n```\n\n### 3. Set Up MicroSocks on SecureEdge Pro\n\n- Access the local web interface of the SecureEdge Pro.\n- Create a `microsocks` container using the `microsocks` image with the following port mappings:\n\n  ```\n  Port Mapping: 1080:1080\n  ```\n\n- Overwrite the default environment variables:\n\n  ```\n  SOCKS_USER\n  SOCKS_PASS\n  ```\n\nRefer to the screenshot for configuration details:  \n![Create Container](secure_edge_pro_settings/create_container.png)\n\n### 4. Start the Containers\n\n- Wait for the containers to be created.\n- Start the containers.\n\n### 5. You now have a running MicroSocks container on your SecureEdge Pro!\n\n### 6. Configure Your Client\n\n- Configure your client to use the SOCKS5 proxy with the IP address of the SecureEdge Pro and port 1080.\n- Use the provided username and password.\n\n## Additional Information\n\nGoogle Chrome does not natively support SOCKS5 proxies with username and password authentication. This limitation means that even if your SOCKS5 proxy requires authentication, Chrome cannot provide the necessary credentials during connection. As a result, attempts to use such proxies directly in Chrome will fail.\n\nhttps://github.com/FelisCatus/SwitchyOmega/issues/1455?utm_source=chatgpt.com\n\noption -1 activates auth_once mode: once a specific ip address authed successfully with user/pass, it is added to a whitelist and may use the proxy without auth. this is handy for programs like chrome that don't support user/pass auth. for it to work you'd basically make one connection with another program that supports it, and then you can use firefox too. for example, authenticate once using curl:\n\n```bash\ncurl --socks5 yourUsername:yourPassword@192.168.140.1:1080 example.com\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixoncloud%2Fedge-app-microsocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fixoncloud%2Fedge-app-microsocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixoncloud%2Fedge-app-microsocks/lists"}