Sign inSign up

molinaig/hideme-proxy

By molinaig

•Updated 3 months ago

Image
0

223

molinaig/hideme-proxy repository overview

⁠hideme-proxy

Docker container with hide.me VPN client and Squid proxy.

The idea is simple:

Client -> Squid Proxy -> hide.me VPN -> Internet

Official hide.me website:

https://hide.me/⁠

⁠Docker Compose example

services:
  hideme-proxy:
    image: molinaig/hideme-proxy:latest
    container_name: hideme-proxy
    restart: unless-stopped

    cap_add:
      - NET_ADMIN

    devices:
      - /dev/net/tun:/dev/net/tun

    ports:
      - "3129:3128"

    environment:
      HIDEME_USERNAME: "your_hideme_username"
      HIDEME_PASSWORD: "your_hideme_password"
      HIDEME_SERVER: "free-fr.hideservers.net"

      SQUID_USERNAME: "proxy_user"
      SQUID_PASSWORD: "proxy_password"

⁠Available free hide.me servers

free-fi.hideservers.net
free-fr.hideservers.net
free-de.hideservers.net
free-nl.hideservers.net
free-ch.hideservers.net
free-uk.hideservers.net
free-us.hideservers.net

⁠Start container

docker compose up -d

⁠View logs

docker logs -f hideme-proxy

⁠Test proxy

curl -x http://proxy_user:[email protected]:3129 http://ip-api.com/json

Expected output should show the public IP and country of the selected hide.me VPN server.

Example:

{
  "status": "success",
  "country": "France",
  "countryCode": "FR",
  "query": "51.159.xxx.xxx"
}

⁠Requirements

The container requires:

  • NET_ADMIN capability
  • /dev/net/tun device
  • Valid hide.me credentials
  • A selected hide.me server

⁠Network Diagram

                    +-------------------+
                    |   hide.me VPN     |
                    +---------+---------+
                              ^
                              |
                              |
+-----------+       +---------+---------+
|  Client   | ----> |      Squid        |
+-----------+       +---------+---------+
                              |
                              |
                    +---------+---------+
                    |  hideme-proxy     |
                    |    Container      |
                    +-------------------+

⁠Port Mapping

Internal Squid listens on port 3128.

Example:

Host:3129 -> Container:3128

This allows multiple proxy containers to run on the same host using different host ports.

Tag summary

Content type

Image

Digest

sha256:afc10022a…

Size

79.6 MB

Last updated

3 months ago

docker pull molinaig/hideme-proxy