mehdok / outline-bridge-server

Outline bridge server: Docker Compose files to run V2Ray as bridge server for Outline

Outline Bridge Server

This repository contains Docker Compose files to run the V2Ray proxy as a bridge server for the Outline proxy. It helps the Outline proxy to work in highly restricted networks without direct/safe/stable access to Outline servers.

Documentation

Outline

Outline is a Shadowsocks-based proxy created by Google. It lets you create and manage Shadowsocks servers easily. Outline clients are also well-designed applications available for all platforms.

It usually works as below.

[Outline client] <-> [Outline server] <-> (Internet)

Read the Outline official documentation to set up an Outline server.

V2Ray as Bridge Server

The bridge server will be inserted between clients and a server to connect the clients to the server in networks where this direct connection is not possible/safe/stable. It runs a V2Ray proxy to pass the incoming Shadowsocks traffic (TCP and UDP) from clients to the Outline server.

The bridge server changes the flow as below.

[Outline client] <-> [V2Ray server] <-> [Outline server] <-> (Internet)

Setup

Follow these steps to set up the V2Ray and Outline:

1. Install Docker and Docker-compose on the bridge server.
2. Clone this repository into the bridge server.
3. Run ./setup.py script. It gets the following inputs:
   1. Outline Server Hostname: Find it in Outline Manager > {Server} > Settings > Hostname
   2. Outline Server Port: Find it in Outline Manager > {Server} > Settings > Port
   3. Allow the port for incoming/outcoming traffic if you have a firewall.
4. Run docker-compose up -d.
5. Change Outline Manager > {Server} > Settings > Hostname field to the bridge server IP address.
6. Delete old access keys in the Outline Manager and generate new ones.
7. Download Outline client applications and add the new access keys there.
8. Enjoy the freedom!

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

• V2Ray Docker Compose