当前位置：首页 > news >正文

Wan2.2-I2V-A14B部署教程：Linux系统下端口映射与远程访问配置

news 2026/6/7 9:30:45

Wan2.2-I2V-A14B部署教程：Linux系统下端口映射与远程访问配置

1. 镜像概述与准备工作

Wan2.2-I2V-A14B是一款专为文生视频任务优化的私有部署镜像，基于RTX 4090D 24GB显存显卡深度适配。本教程将指导您完成Linux系统下的端口映射配置，实现远程访问WebUI和API服务。

1.1 硬件与系统要求

显卡：必须使用RTX 4090D 24GB显存
内存：最低120GB RAM
存储：系统盘50GB + 数据盘40GB
操作系统：Ubuntu 20.04/22.04 LTS
网络：服务器需有固定公网IP或内网穿透能力

1.2 基础环境检查

在开始配置前，请确认已完成以下步骤：

镜像已正确部署到服务器
能通过SSH正常登录服务器
已测试本地访问WebUI和API服务
记录当前服务端口号（默认7860和8000）

2. 本地端口映射配置

2.1 确认服务运行状态

首先检查服务是否正常运行：

# 查看WebUI服务进程 ps aux | grep start_webui.sh # 查看API服务进程 ps aux | grep start_api.sh

如果服务未运行，请先启动服务：

cd /workspace bash start_webui.sh & bash start_api.sh &

2.2 修改默认端口（可选）

如果默认端口被占用，可以修改启动脚本中的端口号：

# 编辑WebUI启动脚本 nano /workspace/start_webui.sh # 找到--port参数修改为其他端口（如7870） # 编辑API启动脚本 nano /workspace/start_api.sh # 修改uvicorn的--port参数（如8010）

修改后需要重启服务：

pkill -f "start_webui.sh" pkill -f "start_api.sh" cd /workspace bash start_webui.sh & bash start_api.sh &

3. 防火墙配置

3.1 开放防火墙端口

确保防火墙允许外部访问服务端口：

# 查看防火墙状态 sudo ufw status # 开放WebUI端口（以7860为例） sudo ufw allow 7860/tcp # 开放API端口（以8000为例） sudo ufw allow 8000/tcp # 启用防火墙（如果尚未启用） sudo ufw enable

3.2 验证端口可访问性

在服务器上测试端口是否可访问：

# 检查WebUI端口 curl -v http://localhost:7860 # 检查API端口 curl -v http://localhost:8000/docs

4. 远程访问方案

4.1 直接公网IP访问（适用于有固定IP）

如果服务器有公网IP，可直接通过浏览器访问：

http://<服务器公网IP>:7860 # WebUI http://<服务器公网IP>:8000/docs # API文档

4.2 SSH隧道转发（推荐安全方案）

对于更安全的访问方式，可使用SSH端口转发：

# 本地执行（将本地7861映射到远程7860） ssh -L 7861:localhost:7860 username@server_ip # 新终端中执行（将本地8001映射到远程8000） ssh -L 8001:localhost:8000 username@server_ip

然后通过本地浏览器访问：

http://localhost:7861 # WebUI http://localhost:8001/docs # API文档

4.3 Nginx反向代理（生产环境推荐）

对于生产环境，建议使用Nginx作为反向代理：

安装Nginx：

sudo apt update sudo apt install nginx

创建配置文件：

sudo nano /etc/nginx/sites-available/wan2proxy

添加以下内容（替换your_domain.com）：

server { listen 80; server_name your_domain.com; location / { proxy_pass http://localhost:7860; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /api/ { proxy_pass http://localhost:8000/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/wan2proxy /etc/nginx/sites-enabled sudo nginx -t sudo systemctl restart nginx

5. 安全加固建议

5.1 基础安全措施

更改默认SSH端口：修改/etc/ssh/sshd_config中的Port
禁用root登录：设置PermitRootLogin no
启用密钥登录：设置PasswordAuthentication no
配置fail2ban：防止暴力破解

5.2 API访问控制

对于API服务，建议添加基础认证：

修改API启动脚本：

nano /workspace/start_api.sh

在uvicorn命令后添加：

--username your_username --password your_password

重启API服务：

pkill -f "start_api.sh" cd /workspace bash start_api.sh &

6. 常见问题解决

6.1 连接问题排查

无法访问WebUI：
- 检查服务是否运行：ps aux | grep gradio
- 检查端口监听：netstat -tulnp | grep 7860
- 检查防火墙：sudo ufw status
API返回502错误：
- 检查API服务日志：tail -f /workspace/api.log
- 检查显存使用：nvidia-smi
- 尝试重启服务