{"id":49261290,"url":"https://github.com/liaisonio/liaison","last_synced_at":"2026-04-25T07:05:59.331Z","repository":{"id":332243523,"uuid":"1011933037","full_name":"liaisonio/liaison","owner":"liaisonio","description":"Liaison uses connectors to access devices and apps behind NAT. Connect home, office, and data center environments with stable, secure connectivity, without exposing LAN or home network ports.","archived":false,"fork":false,"pushed_at":"2026-04-25T02:57:44.000Z","size":12704,"stargazers_count":27,"open_issues_count":2,"forks_count":11,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-25T03:20:39.140Z","etag":null,"topics":["nat-traversal","proxy","sdp","zta","ztna"],"latest_commit_sha":null,"homepage":"https://liaison.cloud","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liaisonio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-01T14:50:45.000Z","updated_at":"2026-04-24T04:01:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"0cac42fd-afc8-41e2-a1c4-a0d879367960","html_url":"https://github.com/liaisonio/liaison","commit_stats":null,"previous_names":["singchia/liaison","liaisonio/liaison"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/liaisonio/liaison","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liaisonio%2Fliaison","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liaisonio%2Fliaison/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liaisonio%2Fliaison/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liaisonio%2Fliaison/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liaisonio","download_url":"https://codeload.github.com/liaisonio/liaison/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liaisonio%2Fliaison/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32253252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T04:23:17.126Z","status":"ssl_error","status_checked_at":"2026-04-25T04:21:53.360Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nat-traversal","proxy","sdp","zta","ztna"],"created_at":"2026-04-25T07:05:59.251Z","updated_at":"2026-04-25T07:05:59.323Z","avatar_url":"https://github.com/liaisonio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"docs/diagrams/liaison-logo.svg\" height=\"40\" align=\"absmiddle\" alt=\"\" /\u003e Liaison\n\n\u003e **Connector-powered access to devices and apps behind NAT**\n\n[![Go](https://github.com/liaisonio/liaison/actions/workflows/go.yml/badge.svg)](https://github.com/liaisonio/liaison/actions/workflows/go.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/liaisonio/liaison)](https://goreportcard.com/report/github.com/liaisonio/liaison)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Tech](https://img.shields.io/badge/Tech-Go%20%7C%20TypeScript%20%7C%20React-blue)](#)\n[![Version](https://img.shields.io/badge/Version-v1.5.0-green)](#)\n\nEnglish | [简体中文](./README_zh.md) | [日本語](./README_ja.md) | [한국어](./README_ko.md) | [Español](./README_es.md) | [Français](./README_fr.md) | [Deutsch](./README_de.md)\n\n![Dashboard](docs/pages/home_en.png)\n\n| Jellyfin (Stream Home Movies Anywhere) | OpenClaw (Use Home AI Anywhere) |\n|:---:|:---:|\n| ![Jellyfin](docs/pages/jellyfin-ss.png) | ![OpenClaw](docs/pages/openclaw-ss.png) |\n\n[Quick Start](#quick-start) • [Introduction](#introduction) • [Documentation](#documentation) • [Contributing](#contributing)\n\n---\n\n## Introduction\n\nLiaison 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.\n\nThis project addresses:\n\n- **Private network access** — Reach devices and services behind NAT from the public internet with minimal setup\n- **Multi-device management** — Manage devices across locations with Linux/macOS/Windows support\n- **Secure connectivity** — TLS-encrypted transport without exposing ports on your LAN or home network\n- **Per-entry firewall** — Source-IP CIDR allowlist on each TCP or HTTP entry, enforced at connection accept\n- **Traffic monitoring** — Real-time device status and traffic metrics for operations and capacity planning\n- **Application proxy** — TCP, HTTP/HTTPS, WebSocket and other protocols\n- **API automation** — Personal Access Tokens (PAT) for CLI/scripts with a browser-mediated sign-in flow at `/cli-auth`\n\nUse cases:\n\n\u003cdiv align=\"center\"\u003e\n\n| **💼 Remote Work \u0026 Dev** | **🧑‍💻 Personal Studio** | **🏠 Home Network / NAS** | **🌐 Multi-datacenter / Multi-region** | **⚡ Edge \u0026 Ops** |\n|:---:|:---:|:---:|:---:|:---:|\n| 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 |\n\n\u003c/div\u003e\n\n---\n\n## Quick Start\n\nPick one of the two server deployment options, then install a connector.\n\n### Install Server — Option 1: Binary + systemd\n\n**1. Download**\n\n```bash\nwget https://github.com/liaisonio/liaison/releases/download/v1.5.0/liaison-1.5.0-linux-amd64.tar.gz\ntar -xzf liaison-1.5.0-linux-amd64.tar.gz\ncd liaison-1.5.0-linux-amd64\n```\n\n**2. Run install script**\n\n```bash\nsudo ./install.sh\n```\n\nYou will be prompted for a public IP or domain; if none is entered within 30 seconds, the detected public IP is used.\n\n**3. Open Web console**\n\nVisit `https://your-public-ip` to access the Web console.\n\n\u003e **Tip:** Default admin credentials are shown in the install script output or config.\n\n### Install Server — Option 2: Docker Compose\n\nRequires Docker 20.10+ with the `docker compose` plugin. The bundle ships `liaison` + `frontier` as two containers; images are pre-built — no registry or source checkout needed.\n\n```bash\nwget https://github.com/liaisonio/liaison/releases/download/v1.5.0/liaison-1.5.0-docker-amd64.tar.gz\ntar -xzf liaison-1.5.0-docker-amd64.tar.gz\ncd liaison-1.5.0-docker-amd64\n./load.sh\n```\n\n`load.sh` auto-detects your public IP (with a 30-second countdown prompt), loads the bundled images, starts the stack, and prints the one-time admin password when liaison is ready. Save the password and open `https://\u003cpublic-ip\u003e` to log in.\n\nData (`data/` SQLite), TLS certs (`certs/`), and logs (`logs/`) are bind-mounted next to `docker-compose.yaml` for persistence. See [`deploy/docker/README.md`](deploy/docker/README.md) for source builds, upgrade / reset / reverse-proxy / custom-cert recipes.\n\n### Install Connector\n\n**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.\n\n---\n\n## System Requirements\n\n| Component | Requirements |\n|:---|:---|\n| **Server** | Linux (Ubuntu 20.04+ or CentOS 7+ recommended) |\n| **Connector** | Linux / macOS / Windows (x86_64 and ARM64) |\n| **Browser** | Chrome 90+, Firefox 88+, Safari 14+, Edge 90+ |\n\n---\n\n## Architecture\n\n\u003cimg src=\"./docs/diagrams/liaison.png\" width=\"80%\"\u003e\n\nLiaison uses a centralized architecture with Frontier managing all connectors.\n\n**Components**\n\n- **Liaison** — Web UI and API, plus application entry points\n- **Frontier** — Connector gateway that handles connector connections and traffic routing\n- **Edge** — Connector client on target devices\n\n---\n\n## Feature Showcase\n\n| Feature | Screenshot |\n|:---:|:---:|\n| Device Management | ![Device](docs/pages/device_en.png) |\n| Application Management | ![Application](docs/pages/application_en.png) |\n| Proxy Configuration | ![Proxy](docs/pages/proxy_en.png) |\n| Edge Management | ![Edge](docs/pages/edge_en.png) |\n\n---\n\n## Documentation\n\n- [Business flow](./docs/biz_sequence.md)\n- [API](./docs/swagger/)\n\n---\n\n## Contributing\n\nContributions are welcome.\n\n- [Report a bug](https://github.com/liaisonio/liaison/issues/new?template=bug_report.md)\n- [Suggest a feature](https://github.com/liaisonio/liaison/issues/new?template=feature_request.md)\n- [Open a PR](https://github.com/liaisonio/liaison/pulls)\n- [Improve docs](https://github.com/liaisonio/liaison/issues/new?template=documentation.md)\n\n1. Fork the repo  \n2. Create a branch (`git checkout -b feature/AmazingFeature`)  \n3. Commit (`git commit -m 'Add some AmazingFeature'`)  \n4. Push (`git push origin feature/AmazingFeature`)  \n5. Open a Pull Request  \n\n---\n\n## License\n\n[Apache License 2.0](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**If this project helps you, please give it a ⭐ Star!**\n\nMade with ❤️ by [Liaison Contributors](https://github.com/liaisonio/liaison/graphs/contributors)\n\n[GitHub](https://github.com/liaisonio/liaison) • [Issues](https://github.com/liaisonio/liaison/issues) • [Discussions](https://github.com/liaisonio/liaison/discussions)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliaisonio%2Fliaison","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliaisonio%2Fliaison","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliaisonio%2Fliaison/lists"}