时间煮雨 - 免流
type: channel
link: https://chun7.top/tag/%E5%85%8D%E6%B5%81/
items: 家庭宽带IPv6搭建3X-UI全攻略

家庭宽带IPv6搭建3X-UI全攻略
type: item
date: 2025-09-22T22:42:00+08:00
description: 🌐 家庭宽带IPv6搭建3X-UI全攻略一、📋 基础环境要求必备条件硬件设备：N1盒子/树莓派/x86设备/云服务器操作系统：OpenWrt/Linux/飞牛等（需支持IPv6）软件平台：Docker + Docker Compose 容器化部署网络环境：支持IPv6的宽带（联通/移动/电信）网络拓扑：主路由或二级路由（建议主路由直接拨号）二、🚀 快速部署方案方案选择建议根据使用习惯选择合适的部署模式：Host模式：适合频繁更改节点的用户，无需重启容器Bridge模式：适合端口固定的生产环境，隔离性更好（推荐）部署命令Host模式部署# 创建数据目录 mkdir -p /opt/3x-ui/{data,cert} # 启动容器 docker run -d --name 3x-ui --restart unless-stopped \ --network host --privileged \ -e PUID=0 -e PGID=0 \ -v /opt/3x-ui/data:/etc/x-ui \ -v /opt/3x-ui/cert:/root/cert \ enwaiax/x-ui:3x-uiBridge模式部署（推荐）创建 docker-compose.yml 文件：version: "3.8" services: 3x-ui: image: enwaiax/x-ui:3x-ui container_name: 3x-ui ports: - "2053:2053" - "50086:50086" - "50087:50087" restart: unless-stopped privileged: true volumes: - ./data:/etc/x-ui - ./cert:/root/cert运行部署命令：docker-compose up -d三、🔧 关键配置步骤1. 防火墙配置详解主路由环境登录路由器管理界面（通常为192.168.1.1）找到"防火墙"或"安全设置"添加入站规则，开放2053、50086、50087及未来需要的节点端口设置允许IPv4和IPv6访问二级路由环境需要配置端口转发外部端口映射到内部设备IP建议使用固定IP地址分配2. 端口验证方法使用在线工具检测端口状态：访问 https://port.tools输入您的IPv6地址或域名填写需要检测的端口号显示"Success"表示端口通畅💡 提示：如果端口检测失败，请检查防火墙设置和容器运行状态3. 动态域名解析（IPv6固定域名）推荐方案对比工具难度功能推荐度DDNS-GO⭐⭐基础解析★★★★★Lucky⭐⭐⭐功能丰富★★★★☆OpenWrt内置⭐⭐简单易用★★★☆☆DDNS-GO基础配置docker run -d --name ddns-go --restart always \ --net=host -v /opt/ddns-go:/root \ jeessy/ddns-go访问 http://localhost:9876 进行配置（具体配置请参考：DDNS-GO解析IPv6教程）4. ⚙️ 管理面板设置初始访问与节点配置首次登录：地址：http://你的IP:2053账号：admin密码：admin节点配置：添加入站规则VLESS+WebSocket：性能最优选择VMESS+WebSocket：兼容性好 四、📱 客户端配置指南各平台客户端推荐平台推荐客户端下载地址Androidv2rayNGhttps://github.com/2dust/v2rayNGiOSShadowrocketApp StoreWindowsV2RayNhttps://github.com/2dust/v2rayNmacOSClashXhttps://github.com/yichengchen/clashX配置导入方式订阅链接：获取订阅地址从面板客户端中导入订阅扫码添加：生成配置二维码客户端扫码导入手动配置：服务器IPv6地址端口和加密方式用户ID和流设置五、手机安装3X-UI如果你没有以上配置：N1盒子/树莓派/x86设备/云服务器但是有一部root后并安装了面具的的手机，可直接刷以下模块{cloud title="手机3x-ui模块" type="default" url="http://ys.chun7.cn:8000/s/64ea27bae62e4e4297" password=""/}刷入模块重启即可！后台地址: http://127.0.0.1:2233用户名: admin 密码: admin📝 注：本文仅提供技术参考，请确保遵守相关法律法规和服务条款。如有其他问题，欢迎在评论区交流讨论！