ArasTey/lunel

选用指南

AI 根据 README 整理 · 2026/10/14 17:11:00

使用方式

通过 Web 控制台（Lunel Console）进行部署和管理，支持从仓库根目录一键部署到支持公共 HTTPS 域名和持久存储的平台。

查看 README 依据

# Lunel **Lunel** is a multi-protocol proxy platform: deploy, monitor, and manage isolated proxy instances (Lunel Core) from a single web console (Lunel Console) — without ever touching a server. Derived from the RVG Gateway relay engine, refactored into a clean product architecture: real deployments, real health checks, real isolation, real endpoints. No simulated states, no fake buttons. ``` GitHub → Lunel Console → Create Instance → Deploy → Running → Endpoint → Manage ``` --- ## What Lunel is | Part | What it is | |---|---|

- **Secret redaction** — logs never carry credentials, tokens or UUID keys. --- ## Quick start (fork and go) Deploy the repository root as **one service** on any platform that gives you a public HTTPS domain and persistent storage (Railway, Render, …): 1. Fork this repo → add a service from the fork **root** with start command `python main.py` → generate a domain → deploy. 2. Open your domain → sign in with the built-in account **admin / admin** → **Create Instance** → Deploy. Zero required variables: embedded SQLite storage and the default admin

部署要求

本地开发需要 Python 3.11+ 和 PostgreSQL；部署到托管平台时零必需环境变量，可选配置 PostgreSQL 和 GitHub OAuth。

查看 README 依据

account (`admin` / `admin` — change it in **Admin → System** on first login) are automatic. Optional: attach a PostgreSQL database (auto-detected via `DATABASE_URL`) and GitHub OAuth (`LUNEL_GITHUB_CLIENT_ID` / `..._SECRET`). Full details in [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md). ### Local development Requires Python 3.11+ and a local PostgreSQL. ```bash python3 -m venv .venv && .venv/bin/pip install -r requirements.txt createdb lunel LUNEL_DATABASE_URL=postgresql://admin:lunel@127.0.0.1:5432/lunel \ LUNEL_GITHUB_CLIENT_ID=... LUNEL_GITHUB_CLIENT_SECRET=... \ .venv/bin/python main.py

已知限制

默认管理员账号为 admin/admin，需在首次登录后更改。

查看 README 依据

- **Secret redaction** — logs never carry credentials, tokens or UUID keys. --- ## Quick start (fork and go) Deploy the repository root as **one service** on any platform that gives you a public HTTPS domain and persistent storage (Railway, Render, …): 1. Fork this repo → add a service from the fork **root** with start command `python main.py` → generate a domain → deploy. 2. Open your domain → sign in with the built-in account **admin / admin** → **Create Instance** → Deploy. Zero required variables: embedded SQLite storage and the default admin

account (`admin` / `admin` — change it in **Admin → System** on first login) are automatic. Optional: attach a PostgreSQL database (auto-detected via `DATABASE_URL`) and GitHub OAuth (`LUNEL_GITHUB_CLIENT_ID` / `..._SECRET`). Full details in [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md). ### Local development Requires Python 3.11+ and a local PostgreSQL. ```bash python3 -m venv .venv && .venv/bin/pip install -r requirements.txt createdb lunel LUNEL_DATABASE_URL=postgresql://admin:lunel@127.0.0.1:5432/lunel \ LUNEL_GITHUB_CLIENT_ID=... LUNEL_GITHUB_CLIENT_SECRET=... \ .venv/bin/python main.py