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 use the ./v2ray-bridge-server/shadowsocks.sh bash script to generate Shadowsocks links (Outline access keys).

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

• 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.