By name: 3x-ui description: 3x-ui (MHSanaei/3x-ui) panel administration — a VLESS/Xray web management UI. Install, configure, manage nodes, reset password, and troubleshoot. Installed at /usr/local/x-ui on this VPS. version: 1.0.0 metadata: hermes: tags: [xray, vless, proxy, panel, vpn, networking]
3x-ui Administration
3x-ui is a web panel for managing Xray/VLESS, Shadowsocks, Trojan, and other proxy protocols.
Quick Status Check
# Service status
sudo systemctl status x-ui
# Port check
sudo lsof -i :49004
# Binary version
/usr/local/x-ui/x-ui 2>&1 | head -3
# Running process
ps aux | grep x-ui | grep -v grep
Current State (This VPS)
| Item | Value |
|---|---|
| Version | 2.9.3 |
| Status | ✅ Running (PID 968) |
| Port | 49004 |
| Web Panel | http://<VPS_IP>:49004 |
| Database | SQLite at /etc/x-ui/x-ui.db |
| Backend | xray-linux-amd64 (PID 1382) |
Access
Open in browser: http://43.155.135.188:49004
Default credentials: admin / admin
Common Operations
# Restart service
sudo systemctl restart x-ui
# Stop / Start
sudo systemctl stop x-ui
sudo systemctl start x-ui
# View logs
sudo journalctl -u x-ui -n 50 --no-pager
# Reset password
/usr/local/x-ui/x-ui setting -username admin -password admin
Password Reset
If you forgot the admin password:
/usr/local/x-ui/x-ui setting -username admin -password admin
sudo systemctl restart x-ui
Reinstall (if needed)
# Stop service
sudo systemctl stop x-ui
# Download installer
bash < <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/main/install.sh)
# Or manual install
cd /usr/local
wget https://github.com/MHSanaei/3x-ui/releases/latest/download/3x-ui-linux-amd64.tar.gz
tar -xzf 3x-ui-linux-amd64.tar.gz
rm 3x-ui-linux-amd64.tar.gz
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| Port 49004 not responding | Service down or firewall | Check systemctl status x-ui, sudo ufw allow 49004 |
| Port works locally but nginx proxy to public IP fails | 3x-ui binds only to 127.0.0.1, not 0.0.0.0 | Use proxy_pass http://127.0.0.1:49004 — see references/reverse-proxy-8443.md |
| "400 The plain HTTP request was sent to HTTPS port" | Upstream 49004 is HTTPS, nginx used HTTP | Use proxy_pass http://127.0.0.1:49004 (nginx terminates SSL, 3x-ui speaks HTTPS locally) |
| "address already in use" | Another process on port | sudo lsof -i :49004 to find conflicting process |
| Can't login | Wrong password | Reset with x-ui setting -username admin -password admin |
| xray backend not running | Config issue | Check /usr/local/x-ui/bin/config.json, journalctl -u x-ui |
| Permission denied on log file | Log dir missing | sudo mkdir -p /var/log/x-ui && sudo chown x-ui:x-ui /var/log/x-ui |
- Nginx 反代理配置（绕过 Cloudflare 端口限制）:
references/reverse-proxy-8443.md
Related
- GitHub: https://github.com/MHSanaei/3x-ui
- 3x-ui vs X-UI (original): This is the updated fork by MHSanaei with more features