alifakhimi / v2ray-docker-compose

V2Ray Docker Compose (Bridge and Upstream Servers)

V2Ray Docker Compose

This repository contains sample Docker Compose files to run V2Ray upstream and bridge servers.

Documentation

Terminology

• Upstream Server: A server that has free access to the Internet.
• Bridge Server: A server that is available to clients and has access to the upstream server.
• Client: A user-side application with access to the bridge server.

(Client) <-> [ Bridge Server ] <-> [ Upstream Server ] <-> (Internet)

Setup

Upstream Server

1. Install Docker and Docker-compose.
2. Copy the v2ray-upstream-server directory into the upstream server.
3. Run cat /proc/sys/kernel/random/uuid command to generate a UUID.
4. Replace <UPSTREAM-UUID> in the config.json file with the generated UUID.
5. Run docker-compose up -d.

Bridge Server

1. Install Docker and Docker-compose.
2. Copy the v2ray-bridge-server directory into the bridge server.
3. Replace the following variables in the config.json file with appropriate values.
   • <SHADOWSOCKS-PASSWORD>: A password for Shadowsocks users like FR33DoM.
   • <BRIDGE-UUID>: A new UUID for bridge server (Run cat /proc/sys/kernel/random/uuid).
   • <UPSTREAM-IP>: The upstream server IP address like 13.13.13.13.
   • <UPSTREAM-UUID>: The generated UUID for the upstream server.
4. Run docker-compose up -d.

Clients

Shadowsocks Protocol

Shadowsocks is a popular proxy protocol with a variety of client applications. We recommend these client applications:

• Outline
• Shadowsocks for macOS
• Shadowsocks for Linux
• Shadowsocks for Windows
• Shadowsocks for Android
• ShadowLink for iOS

You can configure your client application using these settings:

IP Address: <BRIDGE-IP>
Port: 1210
Encryption/Method/Algorithm: aes-128-gcm
Password: <SHADOWSOCKS-PASSWORD>

You can run the following command to generate Shadowsocks links (Outline access keys).

echo "ss://$(echo -n aes-128-gcm:<SHADOWSOCKS-PASSWORD> | base64)@<BRIDGE-IP>:1210"

VMESS Protocol

The VMESS proxy protocol is the primary protocol that V2Ray servers provide. We recommend these client applications:

• V2RayX for macOS
• v2ray-core for Linux
• Qv2ray for Windows
• ShadowLink for iOS
• v2rayNG for Android

You can configure your client application using these settings:

IP Address: <BRIDGE-IP>
Port: 1310
ID/UUID/UserID: <BRIDGE-UUID>
Alter ID: 0
Level: 0
Security/Method/Encryption: aes-128-gcm
Network: TCP

You can use the ./v2ray-bridge-server/vmess.sh bash script to generate VMESS links.

HTTP/HTTPS & SOCKS Protocols

Moved here: HTTP_SOCKS_PROTOCOLS.md

Docker images

We cannot pull docker images from Docker Hub here in Iran. Therefore I've pushed the official V2Ray Docker image into the GitHub image registry. If you prefer pulling the image from the Docker Hub, update the docker-compose.yml files.

• GitHub:
  • Image: ghcr.io/getimages/v2fly-core:v4.45.2
  • URL: https://github.com/orgs/getimages/packages/container/package/v2fly-core
  • Digest: sha256:289fc9451f21a265f95615e29f05ea23bc32026db152863eee317738813521d7
• Docker Hub:
  • Image: v2fly/v2fly-core:v4.45.2
  • URL: https://hub.docker.com/r/v2fly/v2fly-core/tags
  • Digest: sha256:289fc9451f21a265f95615e29f05ea23bc32026db152863eee317738813521d7

More

• Setup V2Ray servers using Ansible: https://github.com/ohmydevops/v2ray-ansible
• Read more about V2Ray: https://www.v2fly.org
• Read more about V2Ray configurations: https://guide.v2fly.org

P.S.

This repository is kind of forked from v2ray-config-examples. Thanks to @xesina and other contributors.