MHSanaei/3x-ui
运维与部署自托管的代理服务器管理面板,用一个网页界面配置多协议入站、客户端配额和多个节点。
3x-ui 是给自己有服务器、想在一个网页面板里管理多种代理协议和用户的人用的。它把原本需要手写和维护 Xray 配置的工作,改成在界面里添加入站、给客户端分配配额和到期时间。
解决什么问题
搭一套代理服务,过去通常要为每种协议单独维护一份 JSON 配置,手动增加用户,再自己记录谁用了多少流量、什么时候该停用。协议一多、端口一多、机器一多,这种账很快就乱了。3x-ui 把这一步变成在面板里添加入站、挂上客户端,并设置流量配额、到期时间、IP 或 HWID 限制,由面板生成底层配置。得到的是一套正在运行的服务、分享链接或二维码、订阅导出,以及按入站、客户端和出站统计的流量。
有什么不同
它把平时往往分开部署的协议放在一起:VLESS、VMess、Trojan、Shadowsocks、WireGuard、AmneziaWG、TUIC v5、Hysteria2、MTProto、HTTP/SOCKS 混合、Tunnel 和 TUN,并支持 WebSocket、gRPC、HTTPUpgrade、XHTTP 等传输方式,叠加 TLS、XTLS 和 REALITY。好处是覆盖面广而不必装额外的服务端软件:AmneziaWG 跑在用户态网络栈里,不需要内核模块或额外软件包;TUIC v5 是进程内的 QUIC 服务端,同样接入 Xray 路由和按客户端的流量统计。回退功能还能让多种协议共用同一个端口,简化证书和端口规划。
代价是面板本身成了一个站在网络服务前面的高权限管理面。基于 Fail2ban 的 IP 限制通过 iptables 执行,需要 NET_ADMIN,所以用 docker run 启动却漏掉该能力时,封禁会写进日志但不会真正生效。默认的 SQLite 单文件适合小规模;客户端数量多或有多节点需求时,更适合 PostgreSQL 后端,文档也给出了迁移方式。多节点管理和跨服务器克隆入站很方便,但也意味着一块面板在管多台主机。
谁值得试
适合有自己服务器、需要多用户代理,并且想要按客户端配额、到期、IP/HWID 限制和订阅链接来管理的人,也适合需要在一台机器上多协议共用端口、或用一块面板管几个节点的小规模运营者。不太适合只在一台机器上跑一种协议的单用户:面板和数据库都是额外的部件,收益有限。无交互安装、常见云平台的 cloud-init 模板和 Docker Compose 方式,对需要重复部署的人更有意义;而希望完全不给主机层权限的人,会被 Fail2ban 的能力要求绊住。
使用条件与边界
安装器面向一长串 Linux 发行版并支持 Windows,架构包括 amd64、386、arm64 以及多种 arm 和 s390x,上线前应先核对自己的服务器。数据库是长期选择而不是勾选项:SQLite 是 /etc/x-ui/x-ui.db 单文件,文档中的 PostgreSQL 迁移会保留原文件,需要你在确认新后端后再手动删除。日常维护包括服务启停、安装时生成的随机凭据、通过 x-ui 菜单管理 SSL 证书,以及在容器里让 Fail2ban 真正生效。
安装通过拉取并执行脚本完成,发布包附带 .sha256 校验和并由安装器与更新器验证,另有 dev-latest 滚动预发布通道,适合想跟 main 分支构建而不是稳定版本的人,这是实际运维上的区别。安装细节和 API 参考见文档,部署模板见 deploy 目录。
HotRepo 点评
HotRepo 目前只有一条有日期的记录:2026-10-25 登上 GitHub Trending 日榜,当时 48,535 星,当天 +59。只有一个观测日期,无法判断关注度是否持续。仓库创建于 2023 年 2 月,单凭这一点也说明不了维护质量。决定采用前,先确认你需要的数据库后端,以及你的部署方式是否保留了 Fail2ban 所需的 NET_ADMIN;这两项对日常运行的影响比协议列表更大。
本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。