# xui-install

**Repository Path**: toocruel/xui-install

## Basic Information

- **Project Name**: xui-install
- **Description**: 使用window 脚本连接云服务器安装部署xui
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# X-UI 快速安装指南

## 🚀 一键安装（推荐）

**1. 托管文件**

将 `install.sh` 和 `x-ui-linux-amd64.tar.gz` 放到任意文件服务器上，使其可通过 HTTP 访问。

启动临时文件服务器（在文件所在目录执行）：
```bash
python3 -m http.server 8080
```

**2. 新服务器上执行**

```bash
curl -L https://ai.iqismart.cn/install/xui/install.sh | bash
```

**3. 登录面板**

```
http://新服务器IP:54321
```
默认用户名 `admin`，密码 `admin`。**立即修改默认密码！**

---

## 备选安装方式

### 方法一：PowerShell 推送安装

在本项目目录下运行：

```powershell
.\install-xui.ps1 -ServerIP 服务器IP -User ubuntu
```

### 方法二：手动安装

1. 上传安装包：
```bash
scp x-ui-linux-amd64.tar.gz ubuntu@服务器IP:/home/ubuntu/
```

2. SSH 连接并安装：
```bash
ssh ubuntu@服务器IP
cd /home/ubuntu
tar -xzf x-ui-linux-amd64.tar.gz
sudo rm -rf /usr/local/x-ui
sudo mkdir -p /usr/local/x-ui
sudo mv x-ui/* /usr/local/x-ui/
sudo chmod +x /usr/local/x-ui/x-ui
sudo chmod +x /usr/local/x-ui/bin/xray-*
sudo cp -f /usr/local/x-ui/x-ui.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable x-ui
sudo systemctl start x-ui
```

## 📝 访问面板

安装完成后，在浏览器访问：

```
http://服务器IP:54321
```

**默认登录信息：**
- 用户名: `admin`
- 密码: `admin`

## 📱 客户端下载

安装完成后，需要在设备上安装客户端来使用代理：

### Windows 推荐
- **V2RayN** (推荐) - https://github.com/2dust/v2rayN/releases
- **Clash for Windows** - https://github.com/Fndroid/clash_for_windows_pkg/releases

### Android
- **V2RayNG** - https://github.com/2dust/v2rayNG/releases

### iOS / iPadOS
- **Shadowrocket** (收费) - App Store

📖 **详细使用说明**: 查看 [CLIENT-GUIDE.md](CLIENT-GUIDE.md) 或 [CLIENT-DOWNLOAD.md](CLIENT-DOWNLOAD.md)

## ⚠️ 安全建议

1. ✅ **立即修改默认密码**
2. ✅ 修改默认端口（可选）
3. ✅ 配置防火墙规则
4. ✅ 定期更新系统和面板

## 🔧 常用管理命令

```bash
# 查看服务状态
systemctl status x-ui

# 启动服务
systemctl start x-ui

# 停止服务
systemctl stop x-ui

# 重启服务
systemctl restart x-ui

# 查看日志
journalctl -u x-ui -f

# 禁用开机自启
systemctl disable x-ui

# 启用开机自启
systemctl enable x-ui
```

## 🔥 防火墙配置

如果服务器有防火墙，需要开放端口：

### UFW (Ubuntu/Debian)
```bash
ufw allow 54321/tcp
ufw reload
```

### Firewalld (CentOS/RHEL)
```bash
firewall-cmd --permanent --add-port=54321/tcp
firewall-cmd --reload
```

### iptables
```bash
iptables -A INPUT -p tcp --dport 54321 -j ACCEPT
service iptables save
```

## 📂 重要目录

- 安装目录: `/usr/local/x-ui/`
- 配置文件: `/etc/x-ui/`
- 服务文件: `/etc/systemd/system/x-ui.service`
- 数据库文件: `/etc/x-ui/x-ui.db`

## 🔄 更新 X-UI

如果需要更新到新版本：

1. 停止当前服务：
```bash
systemctl stop x-ui
```

2. 备份配置：
```bash
cp -r /etc/x-ui /etc/x-ui.backup
```

3. 重复安装步骤

4. 启动服务：
```bash
systemctl start x-ui
```

## ❌ 卸载 X-UI

```bash
systemctl stop x-ui
systemctl disable x-ui
rm -rf /usr/local/x-ui
rm -rf /etc/x-ui
rm -f /etc/systemd/system/x-ui.service
systemctl daemon-reload
```

## 📞 故障排查

### 1. 服务无法启动

```bash
# 查看详细日志
journalctl -u x-ui -n 50

# 检查文件权限
ls -la /usr/local/x-ui/

# 手动运行测试
/usr/local/x-ui/x-ui
```

### 2. 无法访问面板

- 检查服务是否运行: `systemctl status x-ui`
- 检查防火墙: `ufw status` 或 `firewall-cmd --list-all`
- 检查端口占用: `netstat -tlnp | grep 54321`
- 检查云服务商安全组规则

### 3. 端口冲突

如果 54321 端口被占用，可以修改配置文件后重启服务。

## 📌 版本信息

- X-UI 版本: 0.3.2
- 支持系统: Linux (amd64)
- 安装包: x-ui-linux-amd64.tar.gz

---

**最后更新**: 2026-02-05