English | 中文
Connector-powered access to devices and apps behind NAT
| Jellyfin (Stream Home Movies Anywhere) | OpenClaw (Use Home AI Anywhere) |
|---|---|
 |
 |
Quick Start • Introduction • Documentation • Contributing
Liaison is an enterprise-grade application access solution that can be enabled or disabled at any time, without exposing ports on your LAN or home network. It provides a complete feature set: automatic app discovery on connected devices, real-time traffic metrics, and secure TLS-encrypted transport.
This project addresses:
- Private network access — Reach devices and services behind NAT from the public internet with minimal setup
- Multi-device management — Manage devices across locations with Linux/macOS/Windows support
- Secure connectivity — TLS-encrypted transport without exposing ports on your LAN or home network
- Traffic monitoring — Real-time device status and traffic metrics for operations and capacity planning
- Application proxy — TCP, HTTP/HTTPS, WebSocket and other protocols
Use cases:
| 💼 Remote Work & Dev | 🧑💻 Personal Studio | 🏠 Home Network / NAS | 🌐 Multi-datacenter / Multi-region | ⚡ Edge & Ops |
|---|---|---|---|---|
| Connect office and home devices for remote development and debugging | Securely connect workstations and private environments with unified device management | Access home NAS and smart-home services from the public internet | Unified connectivity for servers and applications across regions and datacenters | Connect and monitor edge applications with remote health and traffic checks |
1. Download
wget https://github.com/singchia/liaison/releases/download/v1.3.1/liaison-v1.3.1-linux-amd64.tar.gz
tar -xzf liaison-v1.3.1-linux-amd64.tar.gz
cd liaison-v1.3.1-linux-amd642. Run install script
sudo ./install.shYou will be prompted for a public IP or domain; if none is entered within 30 seconds, the detected public IP is used.
3. Open Web console
Visit https://your-public-ip to access the Web console.
Tip: Default admin credentials are shown in the install script output or config.
Create a new connector in the Web console, copy the install command for your platform from the UI, and run it on the target device. The connector will appear in the console automatically.
| Component | Requirements |
|---|---|
| Server | Linux (Ubuntu 20.04+ or CentOS 7+ recommended) |
| Connector | Linux / macOS / Windows (x86_64 and ARM64) |
| Browser | Chrome 90+, Firefox 88+, Safari 14+, Edge 90+ |
Liaison uses a centralized architecture with Frontier managing all connectors.
Components
- Liaison — Web UI and API, plus application entry points
- Frontier — Connector gateway that handles connector connections and traffic routing
- Edge — Connector client on target devices
| Feature | Screenshot |
|---|---|
| Device Management |  |
| Application Management |  |
| Proxy Configuration |  |
| Edge Management |  |
Contributions are welcome.
- Fork the repo
- Create a branch (
git checkout -b feature/AmazingFeature) - Commit (
git commit -m 'Add some AmazingFeature') - Push (
git push origin feature/AmazingFeature) - Open a Pull Request
If this project helps you, please give it a ⭐ Star!
Made with ❤️ by Liaison Contributors
GitHub • Issues • Discussions