全部标签
写点什么
开源架构OpenHarmony算法元宇宙学习方法Web3.0高效工作数据库Python音视频前端AI大数据团队管理程序员运维深度思考低代码redisgolang微服务架构flutter 查看更多

3X-UI：强大的 Xray-core 网页管理面板

作者：qife122
  • 2025-08-21
    福建

  • 本文字数：2690 字

    阅读完需：约 9 分钟

3X-UI：强大的 Xray-core 网页管理面板

项目描述

3X-UI 是一个基于网页的高级开源控制面板，专为管理 Xray-core 服务器而设计。作为原始 X-UI 项目的增强版本，它提供了用户友好的界面，用于配置和监控各种 VPN 和代理协议，包括 VMess、VLESS、Trojan、Shadowsocks 等。


重要提示：本项目仅用于个人使用和通信，请勿将其用于非法目的，请勿在生产环境中使用。

功能特性

  • 多协议支持：全面支持 VMess、VLESS、Trojan、Shadowsocks 等多种代理协议

  • 网页管理界面：直观的 Web-based 控制面板，无需命令行操作

  • 流量监控：实时监控用户流量使用情况，支持流量限制和到期时间设置

  • 客户端管理：细粒度的客户端管理，支持多用户配置

  • 安全特性：集成 Fail2Ban 支持，防止暴力破解攻击

  • 订阅服务：自动生成订阅链接，支持多种客户端订阅

  • 多语言支持：支持中文、英文、波斯语、阿拉伯语等多种语言界面

  • 自动化安装：提供一键安装脚本，简化部署过程

安装指南

系统要求

  • Linux 操作系统（Ubuntu、Debian、CentOS 等）

  • GLIBC 2.32 或更高版本

  • root 权限

一键安装

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
复制代码

手动安装

  1. 下载对应架构的 Xray-core 二进制文件

  2. 配置数据库和运行环境

  3. 启动 Web 服务

依赖项

  • Xray-core v25.6.8 或更高版本

  • SQLite 数据库

  • 必要的系统工具（wget、curl、tar 等）

使用说明

基本使用

  1. 访问面板：安装完成后，通过浏览器访问服务器 IP 和端口（默认端口：2053）

  2. 登录系统：使用默认用户名和密码（admin/admin）登录

  3. 配置入站协议：在"Inbounds"页面添加和配置代理协议

  4. 管理客户端：为每个入站协议添加和管理用户客户端

  5. 监控流量：在仪表板查看实时流量和使用情况

示例配置

创建 VMess 入站示例：


{  "protocol": "vmess",  "port": 443,  "settings": {    "clients": [      {        "id": "自动生成的UUID",        "email": "user@example.com",        "enable": true      }    ]  },  "streamSettings": {    "network": "ws",    "security": "tls"  }}
复制代码

API 使用

3X-UI 提供 RESTful API 接口，支持程序化管理：


# 获取所有入站配置curl -X POST http://localhost:2053/panel/api/inbounds/list \  -H "Authorization: Bearer <token>"
复制代码

核心代码

主程序入口

package main
import (  "x-ui/config"  "x-ui/database"  "x-ui/logger"  "x-ui/web"  "x-ui/web/global")
func runWebServer() {  // 初始化日志系统  logger.InitLogger(logging.INFO)    // 初始化数据库  err := database.InitDB(config.GetDBPath())  if err != nil {    log.Fatalf("Error initializing database: %v", err)  }    // 启动Web服务器  server := web.NewServer()  global.SetWebServer(server)  err = server.Start()  if err != nil {    log.Fatalf("Error starting web server: %v", err)  }}
复制代码

数据库模型

package database
import (  "gorm.io/gorm"  "x-ui/database/model")
// 初始化数据表结构func initModels() error {  models := []any{    &model.User{},           // 用户表    &model.Inbound{},        // 入站配置表    &model.Setting{},        // 系统设置表    &model.InboundClientIps{}, // 客户端IP记录表  }    for _, model := range models {    if err := db.AutoMigrate(model); err != nil {      return err    }  }  return nil}
// 初始化默认用户func initUser() error {  user := &model.User{    Username: "admin",    Password: "加密后的密码",  }  return db.Create(user).Error}
复制代码

Xray 配置生成

package xray
// 生成Xray配置文件func GenerateConfig(inbounds []*model.Inbound) (string, error) {  config := map[string]interface{}{    "log": map[string]interface{}{      "loglevel": "warning",    },    "inbounds":  generateInboundsConfig(inbounds),    "outbounds": generateOutboundsConfig(),    "routing":   generateRoutingConfig(),  }    configJson, err := json.MarshalIndent(config, "", "  ")  if err != nil {    return "", err  }    return string(configJson), nil}
// 生成入站配置func generateInboundsConfig(inbounds []*model.Inbound) []interface{} {  var configInbounds []interface{}    for _, inbound := range inbounds {    if !inbound.Enable {      continue    }        inboundConfig := map[string]interface{}{      "port":     inbound.Port,      "protocol": inbound.Protocol,      "settings": inbound.Settings,      "sniffing": map[string]interface{}{        "enabled":      true,        "destOverride": []string{"http", "tls"},      },    }        configInbounds = append(configInbounds, inboundConfig)  }    return configInbounds}
复制代码

订阅服务

package sub
// 处理订阅请求func (s *SubService) GetSubs(subId string, host string) ([]string, string, error) {  inbounds, err := s.getInboundsBySubId(subId)  if err != nil {    return nil, "", err  }
  var result []string  for _, inbound := range inbounds {    clients, err := s.inboundService.GetClients(inbound)    if err != nil {      continue    }        for _, client := range clients {      if client.Enable && client.SubID == subId {        link := s.getLink(inbound, client.Email)        result = append(result, link)      }    }  }    // 返回Base64编码的订阅内容  if s.subEncrypt {    return []string{base64.StdEncoding.EncodeToString([]byte(strings.Join(result, "\n")))}, header, nil  }    return result, header, nil}
复制代码

流量统计

package job
// 流量统计任务func (j *XrayTrafficJob) Run() {  if !j.xrayService.IsXrayRunning() {    return  }    // 获取流量数据  traffics, clientTraffics, err := j.xrayService.GetXrayTraffic()  if err != nil {    return  }    // 更新数据库中的流量统计  err, needRestart0 := j.inboundService.AddTraffic(traffics, clientTraffics)  if err != nil {    logger.Warning("add inbound traffic failed:", err)  }    // 如果需要重启服务  if needRestart0 {    j.xrayService.SetToNeedRestart()  }}
复制代码


更多精彩内容 请关注我的个人公众号 公众号（办公 AI 智能小助手）公众号二维码


办公AI智能小助手


划线
评论
复制
发布于: 2025-08-21阅读数: 2
vpnXray
用户头像

qife122

关注

还未添加个人签名 2021-05-19 加入

还未添加个人简介

评论

发布
暂无评论
Copyright © 2025, Geekbang Technology Ltd. All rights reserved. 极客邦控股（北京）有限公司 | 京 ICP 备 16027448 号 - 5京公网安备京公网安备 11010502039052号 | 产品资质
3X-UI：强大的Xray-core网页管理面板_vpn_qife122_InfoQ写作社区