azure-relay-bridge

(★ 163)

Azure Relay Bridge - A cross-platform command line tool to create VPN-less TCP tunnels from and to anywhere

File Explorer

Download Latest Version (.zip)

- - main-ci-build.yml
- Key.snk
- repo.props
- sources.props
- - client_config.yml
  - Deploy-Relay.ps1
  - README.md
  - relay-resource-template.json
  - server_config.yml
- - client_config.yml
  - Deploy-Relay.ps1
  - README.md
  - relay-resource-template.json
  - server_config.yml
- - assets.pptx
  - azurerelay.ico
  - dlgbanner.bmp
  - dlgbkgnd.bmp
- - appsettings.Development.json
  - appsettings.json
  - azbridge.csproj
  - azbridge.plist
  - azbridge.service
  - azbridge.sh
  - azbridge_config.machine.yml
  - azbridge_config.svc.yml
  - Directory.Build.props
  - Program.cs
  - RelayBridgeService.cs
  - ServiceLauncher.cs
  - Strings.Designer.cs
  - Strings.resx
  - SubscriberObserver.cs
  - TraceObserver.cs
- - .gitignore
  - azbridge-installer.wixproj
  - build.cmd
  - Directory.Build.props
  - installTransforms.xslt
  - LICENSE.rtf
  - packages.config
  - Product.wxs
  - restore.cmd
  - testinstall.cmd
- - Constants.cs
  - DiagnosticsRecord.cs
  - Directory.Build.props
  - EventSource.cs
  - EventTraceActivity.cs
  - Fx.cs
  - Host.cs
  - IRemoteForwarder.cs
  - LocalForwardHost.cs
  - Microsoft.Azure.Relay.Bridge.csproj
  - Microsoft.Azure.Relay.Bridge.xml
  - RemoteForwardBridge.cs
  - RemoteForwardHost.cs
  - Settings.StyleCop
  - SocketLocalForwardBridge.cs
  - SocketRemoteForwarder.cs
  - StreamPump.cs
  - Strings.Designer.cs
  - Strings.resx
  - TaskEx.cs
  - TcpLocalForwardBridge.cs
  - TcpRemoteForwarder.cs
  - UdpLocalForwardBridge.cs
  - UdpRemoteForwarder.cs
- Directory.Build.props
- - .gitignore
  - Directory.Build.props
  - docker-entrypoint.sh
  - my.cnf
  - mysql.client.dockerfile
  - mysql.server.dockerfile
  - run_client.sh
  - test.cmd
  - Test.proj
  - test.sh
  - test.sql
- - .gitignore
  - centos.9-x64.client.dockerfile
  - centos.9-x64.server.dockerfile
  - debian.10-x64.client.dockerfile
  - debian.10-x64.server.dockerfile
  - Directory.Build.props
  - fedora.34-x64.client.dockerfile
  - fedora.34-x64.server.dockerfile
  - index.html
  - opensuse.15.0-x64.client.dockerfile
  - opensuse.15.0-x64.server.dockerfile
  - run_client.sh
  - run_nginx.sh
  - test.cmd
  - Test.proj
  - test.sh
  - ubuntu.18.04-x64.client.dockerfile
  - ubuntu.18.04-x64.server.dockerfile
  - ubuntu.20.04-x64.client.dockerfile
  - ubuntu.20.04-x64.server.dockerfile
  - ubuntu.22.04-x64.client.dockerfile
  - ubuntu.22.04-x64.server.dockerfile
  - ubuntu.24.04-x64.client.dockerfile
  - ubuntu.24.04-x64.server.dockerfile
- - .gitignore
  - Directory.Build.props
  - index.js
  - package.json
  - README.md
  - run-test.ps1
  - test.cmd
  - Test.proj
- - Directory.Build.props
  - macos_unblock_testip.sh
  - Test.proj
- Directory.Build.props
- relay_cleanup.sh
- relay_setup.sh
.dockerignore
.gitattributes
.gitignore
after.Microsoft.Azure.Relay.Bridge.sln.targets
build.cmd
build.sh
CONFIG.md
CONTRIBUTING.md
Directory.Build.props
Directory.Build.targets
Directory.Packages.props
Dockerfile
INSTALLATION.md
LICENSE.txt
Microsoft.Azure.Relay.Bridge.sln
NuGetPackageVerifier.json
package-all.cmd
package.cmd
package.sh
README.md
run.cmd
run.ps1
run.sh
SECURITY.md
verify-build.cmd
verify-build.sh
version.props

# Installation Guide

1. Get the code

git clone https://github.com/Azure/azure-relay-bridge

Downloads the entire project code from GitHub to your computer.

cd azure-relay-bridge

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -t azure-relay-bridge .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 azure-relay-bridge

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. .NET

Medium

Prerequisites

Git Needed to download the project code from GitHub.
.NET SDK The SDK required for the dotnet command.

dotnet restore

Downloads the packages the project depends on.

dotnet run

Builds the project and runs it immediately.

✅ After dotnet run, check the message or address shown in the terminal.