1. 项目定位与用途
LAN Proxy Gateway 是一个基于 mihomo 内核的开源局域网透明代理网关工具，项目定位为"将普通电脑转变为家庭网络透明代理网关"。其核心用途是让无法安装代理应用的设备（如游戏主机、智能电视）通过修改网关和 DNS 设置即可实现科学上网，同时提供链式代理功能优化 AI 服务访问。项目完全开源，中文优先，主要用于网络与代理技术学习、家庭网关实践和 CLI/TUI 交互探索。用户无需刷路由器或购买软路由，即可为全屋设备提供代理能力。
项目档案命令行工具
Tght1211/lan-proxy-gateway CLI 工具：安装、命令与使用场景
本文介绍 LAN Proxy Gateway，一个基于 mihomo 的开源工具，可将您的电脑设置为局域网透明代理网关。了解如何让 Switch、PS5、Apple TV 等设备通过修改网关和 DNS 实现科学上网，支持链式代理优化 AI 服务访问，提供 macOS、Linux 和 Windows 跨平台安装指南与使用说明。
AI 总结
LAN Proxy Gateway 是一个基于 mihomo 的跨平台局域网透明代理网关工具，可将电脑变为家庭网关，使 Switch、PS5、Apple TV 等设备无需安装代理应用即可科学上网，并支持链式代理优化 AI 服务访问。
中文项目介绍
LAN Proxy Gateway 是一个基于 mihomo 内核开发的开源局域网透明代理网关系统，旨在将普通电脑转变为家庭网络中的透明代理网关设备。项目核心价值在于解决游戏主机、智能电视等无法直接安装代理应用的设备的上网问题，用户只需将这些设备的网关和 DNS 指向运行本程序的电脑即可实现科学上网。
项目主要解决两类网络需求：一是为 Switch、PS5、Apple TV、智能电视等设备提供透明代理能力，使其能够访问国际流媒体服务和在线游戏商店；二是通过链式代理（chains）功能，将 Claude、ChatGPT、Codex、Cursor 等 AI 服务的流量引导至住宅出口代理，提升稳定性和可用性，实现"普通流量走机场，AI 流量走住宅"的分流策略。
适用场景涵盖家庭娱乐和开发工作：游戏主机用户可访问 eShop、PSN 并享受联机加速；流媒体用户在 Apple TV 和智能电视上观看 Netflix、YouTube、Disney+ 等内容；移动设备通过修改局域网设置实现代理上网；AI 开发者和研究者可优化 Codex、Cursor 等工具的连接质量。
技术实现上，项目采用 Go 语言开发，基于 Cobra 框架构建命令行接口，支持 TUN 模式和本机绕过代理配置。提供两种控制台模式：简单命令模式和完整 TUI 工作台，后者包含 Dashboard、代理管理和订阅管理三个 Tab 页。内置规则系统涵盖局域网直连、国内服务直连、Apple/Nintendo 相关规则、广告拦截以及国外网站和 AI 服务代理。项目完全开源，支持 macOS、Linux 和 Windows 三大平台，安装脚本会自动下载适配平台的 mihomo 内核。
详细信息与使用说明
2. 核心问题解决
项目解决两个核心网络问题：一是家庭网络中 Switch、PS5、Apple TV 等设备无法直接配置代理的痛点，通过局域网透明代理技术使这些设备访问国际流媒体和在线服务；二是 AI 服务（Claude/ChatGPT/Codex/Cursor）的访问优化，通过链式代理将 AI 流量引导至住宅出口，提升注册成功率和使用稳定性，实现"普通流量走机场，AI 流量走住宅"的分流策略。项目基于 mihomo 内核，重点做好局域网共享和链式代理两件事。
3. 典型适用场景
主要适用场景包括：游戏主机用户访问 eShop、PSN 商店和享受联机加速；流媒体用户在 Apple TV 和智能电视上观看 Netflix、YouTube、Disney+ 等国际内容；手机和平板通过局域网设置实现代理上网；AI 开发者和研究者使用 Codex、Cursor 等编程工具，以及需要稳定访问 Claude、ChatGPT 的用户。项目特别适合不想刷路由器、不购买软路由的家庭用户，设备只需改网关和 DNS 就能用，支持 TUN 模式和本机绕过代理配置。
4. 跨平台安装指南
项目支持 macOS、Linux 和 Windows 三大平台。macOS/Linux 用户推荐使用 curl 命令执行安装脚本：curl -fsSL https://cdn.jsdelivr.net/gh/Tght1211/lan-proxy-gateway@main/install.sh | bash。Windows 用户需以管理员身份打开 PowerShell，运行 irm https://cdn.jsdelivr.net/gh/Tght1211/lan-proxy-gateway@main/install.ps1 | iex。安装脚本会自动下载对应平台的 mihomo 内核，可通过环境变量 GITHUB_MIRROR 指定镜像源加速下载。脚本会优先快速探测可用下载源，在持续低速时自动切换候选源。
5. 网关启动与配置
安装完成后运行 gateway install 进行初始化配置，依次录入代理来源（订阅链接或本地配置文件）、订阅名称等信息，系统将生成 gateway.yaml 配置文件。启动网关时，macOS/Linux 需使用 sudo gateway start，Windows 需以管理员身份运行 gateway start。启动成功后终端会显示局域网 IP，将此 IP 设置为目标设备的网关和 DNS 即可。可通过 gateway start --tui 进入完整 TUI 控制台，或简单模式下输入 tui 切换，控制台提供节点测速、订阅管理、规则编辑等交互功能。
6. 链式代理与高级功能
链式代理是项目的核心高级功能，配置命令为 gateway chains，需设置住宅代理地址、认证信息和机场测速组名。支持两种路由模式：rule 模式仅将 AI 相关流量导向住宅出口，global 模式则将所有流量走住宅出口。项目提供简单命令模式和完整 TUI 工作台两种交互方式，内置节点测速（支持 T 键重测排序）、订阅档案管理、扩展脚本、TUN 模式控制等功能。规则系统默认包含局域网和保留地址直连、国内常见服务直连、Apple/Nintendo 相关规则、广告与跟踪域名拦截、国外网站和 AI 服务代理。
思维导图
LAN Proxy Gateway
核心命令模块
console.go (控制台逻辑)
start.go (启动流程)
install.go (安装向导)
tun.go (TUN 模式)
chains.go (链式代理)
配置管理
config.go (YAML 配置)
migrate.go (配置迁移)
mihomo 集成
api.go (内核 API)
download.go (内核下载)
平台适配
init_darwin.go (macOS)
init_linux.go (Linux)
root_windows.go (Windows)
文档体系
设备设置指南
高级配置文档
命令参考手册
安装与部署
install.sh (Linux/macOS 脚本)
install.ps1 (Windows 脚本)
download-mihomo.sh (内核下载)
常见问题
LAN Proxy Gateway 支持哪些设备和操作系统？
支持 Switch、PS5、Apple TV、智能电视、手机、平板等设备；操作系统支持 macOS、Linux 和 Windows。设备需连接到同一局域网并修改网关和 DNS 为运行网关的电脑 IP。项目基于 mihomo 内核，提供 TUN 模式和本机绕过代理配置。
如何安装和启动网关？
macOS/Linux 运行 curl -fsSL https://cdn.jsdelivr.net/gh/Tght1211/lan-proxy-gateway@main/install.sh | bash；Windows 以管理员身份运行 PowerShell 命令 irm https://cdn.jsdelivr.net/gh/Tght1211/lan-proxy-gateway@main/install.ps1 | iex。安装后执行 gateway install 初始化，再用 sudo gateway start 启动（Windows 以管理员身份运行 gateway start）。可通过 --tui 参数进入完整 TUI 控制台。
链式代理（chains）功能有什么用？
链式代理让流量经过"机场节点 -> 住宅代理"两级代理后再到达目标服务，特别适合 Claude、ChatGPT、Codex、Cursor 等 AI 服务。配置命令为 gateway chains，支持 rule 模式（仅 AI 流量走住宅出口）和 global 模式（所有流量走住宅出口），可提升 AI 服务注册成功率和日常使用稳定性。
Apple TV 等设备如何配置网络设置？
在设备网络设置中，将 IP 配置改为手动：IP 地址设为同网段未用地址，路由器填写运行网关的电脑 IP，DNS 同样填写电脑 IP。详细步骤见 docs/appletv-setup.md、docs/ps5-setup.md、docs/switch-setup.md 等设备专属指南。Netflix 等流媒体可能需要选择特定解锁节点。
Windows 下更新网关或安装服务如何操作？
gateway update 在 Windows 下会走后台替换流程，当前 .exe 退出后自动完成更新并重新启动网关。gateway service install 在 Windows 下会安装开机自启任务，不需要把 CLI 伪装成 sc.exe 服务。项目仓库中未明确给出 Windows 服务管理的更多细节，具体行为需参考实际运行提示。