This repository contains sample Docker Compose files to run V2Ray upstream and bridge servers.
- 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)
- Install Docker and Docker-compose.
- Copy the
v2ray-upstream-server
directory into the upstream server. - Run
cat /proc/sys/kernel/random/uuid
command to generate a UUID. - Replace
<UPSTREAM-UUID>
in theconfig.json
file with the generated UUID. - Run
docker-compose up -d
.
- Install Docker and Docker-compose.
- Copy the
v2ray-bridge-server
directory into the bridge server. - Replace the following variables in the
config.json
file with appropriate values.<SHADOWSOCKS-PASSWORD>
: A password for Shadowsocks users likeFR33DoM
.<BRIDGE-UUID>
: A new UUID for bridge server (Runcat /proc/sys/kernel/random/uuid
).<UPSTREAM-IP>
: The upstream server IP address like13.13.13.13
.<UPSTREAM-UUID>
: The generated UUID for the upstream server.
- Run
docker-compose up -d
.
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"
The VMESS proxy protocol is the primary protocol that V2Ray servers provide. We recommend these client applications:
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.
Moved here: HTTP_SOCKS_PROTOCOLS.md
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
- Image:
- Docker Hub:
- Image:
v2fly/v2fly-core:v4.45.2
- URL: https://hub.docker.com/r/v2fly/v2fly-core/tags
- Digest:
sha256:289fc9451f21a265f95615e29f05ea23bc32026db152863eee317738813521d7
- Image:
- 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
This repository is kind of forked from v2ray-config-examples. Thanks to @xesina and other contributors.