V2Ray Docker Compose

This repository introduces V2Ray-based solutions to bypass limitations in highly restricted networks without direct/safe/stable access to upstream servers (servers with access to free Internet).

Table of contents

• Server Solutions
  • V2Ray Upsream and Bridge Servers
  • V2Ray Behind a CDN Service
  • V2Ray as Outline Bridge Server (Recommended)
• Client Applications
  • VMESS Protocol
  • Shadowsocks Protocol
  • HTTP and SOCKS Protocols
• Subscription Link
• Tips
• Docker Images
• More
• Star History

Server Solutions

V2Ray Upsream and Bridge Servers

In this solution, you need these two servers:

• Upstream Server: A server that has access to the free Internet.
• Bridge Server: A server that is available to clients and has access to the upstream server.

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

This solution consists of two steps and provides VMESS and Shadowsocks (AEAD) protocols.

Step 1: Setup Upstream Server

1. Install Docker and Docker-compose.
2. Copy the v2ray-upstream-server and the utils directories into the upstream server.
3. Run ./utils/bbr.sh to speed up server network.
4. Run cat /proc/sys/kernel/random/uuid in your terminal to generate a UUID.
5. Replace <UPSTREAM-UUID> in v2ray/config/config.json with the generated UUID.
6. Run docker-compose up -d.

Step 2: Setup Bridge Server

1. Install Docker and Docker-compose.
2. Copy the v2ray-bridge-server and the utils directories into the bridge server.
3. Run ./utils/bbr.sh to speed up server network.
4. Replace the following variables in v2ray/config/config.json 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 upstream server UUID from previous step.
5. Run docker-compose up -d.
6. Run ./clients.py to generate client configurations and links.

V2Ray Behind a CDN Service

In this solution, you need one server (upstream) and a domain/subdomain added to a CDN service.

• Upstream Server: A server that has free access to the Internet.
• CDN Service: A Content delivery network like Cloudflare, ArvanCloud or DerakCloud.

(Client) <-> [ CDN Service ] <-> [ Upstream Server ] <-> (Internet)

This solution provides VMESS over Websockets + TLS + CDN. Read more...

Follow these steps to setup V2Ray + Caddy (Web server) + CDN:

1. In your CDN, create an A record pointing to your server IP with the proxy option turned off.
2. Install Docker and Docker-compose on your server.
3. Copy the v2ray-caddy-cdn and the utils directories into the server.
4. Run ./utils/bbr.sh to speed up server network.
5. Run cat /proc/sys/kernel/random/uuid to generate a UUID.
6. Replace <UPSTREAM-UUID> in v2ray/config/config.json with the generated UUID.
7. Replace <EXAMPLE.COM> in caddy/Caddyfile with your domain/subdoamin.
8. Run docker-compose up -d.
9. Visit your domain/subdomain in your web browser. Wait until the homepage is loaded.
10. (Optional) In your CDN, turn the proxy option on for the record.
11. Run ./vmess.py to generate client configuration (link).

If you prefer NGINX as web server, read V2RAY_NGINX_CDN instead.

Some CDN services don't offer unlimited traffic for free plans. Please check CDN Free Plans.

You don't need to turn the cloud (proxy) on in your CDN (step 10) when the Internet is not blocked. When it's off, clients connect to the server directly and CDN services also don't charge you any fee.

V2Ray as Outline Bridge Server (Recommended)

Moved here: Outline Bridge Server

Client Applications

VMESS Protocol

This is the list of recommended applications to use the VMESS protocol:

• Nekoray for macOS, Windows, and Linux
• Qv2ray for macOS, Windows, and Linux
• V2RayX for macOS
• ShadowLink for iOS
• v2rayNG for Android

Shadowsocks Protocol

This is the list of recommended applications to use the Shadowsocks protocol:

• Outline for all platforms
• ShadowsocksX-NG for macOS
• shadowsocks-libev for Linux
• shadowsocks-windows
• shadowsocks-android
• ShadowLink for iOS

HTTP and SOCKS Protocols

Moved here: HTTP_SOCKS

Subscription Link

Moved here: SUBSCRIPTION_LINK

Tips

• Some hostings might ban your proxy traffic. Use an appropriate hosting.
• Some Internet providers might ban your proxy traffic. Changing AlterID could be helpful. See #57.

Docker Images

By default, this repository uses the GitHub registry. You can modify the Docker-compose file to use Docker Hub.

• 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

• Outline Bridge Server
• V2Ray Config Examples
• NekoRay Installer (for Linux)
• V2Ray Ansible
• V2Fly (V2Ray)
• V2Fly (V2Ray) configurations