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 Relay Servers
  • V2Ray Behind a CDN Service
  • V2Ray as Relay for Outline
• Client Applications
  • Shadowsocks Protocol
  • VMess Protocol
  • HTTP and SOCKS Protocols
• More

Server Solutions

V2Ray Upsream and Relay Servers

This stable solution supports Shadowsocks and VMess by default and can be configured to provide other V2Ray protocols.

In this solution, you need these two servers:

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

(Client) <-> [ Relay 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 Relay Server

1. Install Docker and Docker-compose.
2. Copy the v2ray-relay-server and the utils directories into the relay 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 relay 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 the previous step.
5. Run docker-compose up -d.
6. Run ./clients.py to generate client configurations and links.

V2Ray Behind a CDN Service

This solution is recommended only if you don't have relay server.

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 set up V2Ray + Caddy (Web server) + CDN:

1. On 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/subdomain.
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 the 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 Relay for Outline

This highly recommended solution is stable and easy to set up. Using the Outline Manager app, you can create and manage multiple users and track their traffic. It supports Shadowsocks protocol and offers the easy-to-use Outline client app.

Read more: Outline Bridge Server

Client Applications

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

VMess Protocol

This is the list of recommended applications to use the VMess and other protocols:

• Nekoray for macOS, Windows, and Linux
• FoXray for macOS, iOS, and Android
• V2Box for macOS and iOS
• V2Box for Android
• ShadowLink for iOS
• v2rayNG for Android
• v2rayN for Windows

HTTP and SOCKS Protocols

Moved here: HTTP_SOCKS

More

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