This repository introduces two V2Ray-based solutions to bypass censorship in highly restricted networks without direct access to an upstream server (a server with access to free Internet). These solutions are 1. Using a bridge server, and 2. Using a CDN service.

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.

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 to generate a UUID.
4. Replace <UPSTREAM-UUID> in v2ray/config/config.json with the generated UUID.
5. Run docker-compose up -d.

1. Install Docker and Docker-compose.
2. Copy the v2ray-bridge-server directory into the bridge server.
3. 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.
4. Run docker-compose up -d.
5. Run ./clients.py to generate client configurations and links.

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 + 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 directory into the server.
4. Run cat /proc/sys/kernel/random/uuid to generate a UUID.
5. Replace <UPSTREAM-UUID> in v2ray/config/config.json with the generated UUID.
6. Replace <EXAMPLE.COM> in caddy/Caddyfile with your domain/subdoamin.
7. Run docker-compose up -d.
8. Visit your domain/subdomain in your web browser. Wait until the homepage is loaded.
9. In your CDN, turn the proxy option on for the record.
10. Run ./vmess.py to generate client configuration (link).

If you prefer NGINX instead of the Caddy web server, read V2RAY_NGINX_CDN instead.

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

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

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

Moved here: HTTP_SOCKS

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

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

• Docker Compose files to run an Outline bridge server
• V2Ray Config Examples
• Setup V2Ray servers using Ansible
• Read more about V2Fly and V2Ray
• Read more about V2Ray configurations