远程访问 NPU 服务器并下载视频：minimax-h3-int8 端口映射实操指南
【免费下载链接】minimax-h3-int8项目地址: https://ai.gitcode.com/xujiashuai/minimax-h3-int8
minimax-h3-int8是运行在 Ascend NPU 服务器上的 MiniMax H3 文生视频（T2V）部署项目：用 INT8 量化模型在双 NPU 上生成带声音的短视频。视频生成在服务器内网完成，新手最常卡住的一步是：怎么从自己的电脑打开 Web 界面、把生成的 MP4 下载到本地。本文带你用「端口映射」把服务器上的8188 端口打通，实现远程访问 NPU 服务器并下载视频。
为什么只需要映射 8188 一个端口？
很多新手以为访问界面、下载文件、调用 API 需要多个端口，其实不用。ComfyUI 是单端口服务，界面和接口全走同一个端口：
| 能力 | 访问路径 |
|---|---|
| Web UI 工作流画布 | http://<映射地址>:8188/ |
| 视频查看 / 下载 | http://<映射地址>:8188/view?… |
| API 提交 / 查询 | http://<映射地址>:8188/prompt、/history |
项目的启动脚本默认以--listen 0.0.0.0 --port 8188启动（见 start-comfyui-dual-npu.sh），端口可通过环境变量COMFY_PORT覆盖，示例配置见 dual_npu.example.env。
📌 一句话总结：只要8188通了，远程访问 + 视频下载全部搞定，无需额外开文件服务。
视频到底存在哪？三种远程取片方式
生成的视频统一写入仓库根目录的output/video/（启动脚本通过--output-directory指定），文件形如MiniMax_H3_int8_verify_00001_.mp4（736×416@24fps，约 577 KB）。产物去向详见 directory-map.md。
方式一：/view 端点直接下载（最快）
浏览器打开下面的 URL 即可播放或下载：
http://<映射地址>:8188/view?filename=MiniMax_H3_int8_verify_00001_.mp4&type=output&subfolder=video参数含义：filename只取文件名，type=output指输出目录，subfolder=video对应output/video/子目录。在服务器上本机也可以用curl -O同一条 URL 拉取文件。
方式二：Web UI 里点一下下载（最省心）
打开http://<映射地址>:8188/，在History 面板找到已跑过的任务，点开SaveVideo节点就能直接预览和下载视频。界面能打开，文件就一定能下载——因为前端预览就是靠/view端点拉取的。
方式三：加载工作流重新生成
在 Web UI 加载工作流，修改prompt/seed/length后点 Queue 排队，完成后视频自动出现在输出区。工作流模板见 workflows/api_t2v_int8_turbo.json。
端口映射落地：4 种方式按需选择
目标是让你的浏览器能访问到服务器上的0.0.0.0:8188，按网络条件四选一：
| 方式 | 适用场景 | 做法要点 |
|---|---|---|
| SSH 本地端口转发 | 本机可以 SSH 到服务器 | ssh -L 8188:127.0.0.1:8188 user@服务器，然后浏览器打开http://127.0.0.1:8188 |
| 跳板机端口转发 | 公司内网、只有跳板可达 | 在跳板机做 8188 → 服务器 8188 的 TCP 转发 |
| 内网穿透（frp / ngrok / cloudflared） | 服务器有外网出口 | 服务器与一台公网 VPS 配对，把 8188 暴露成公网地址 |
| 云平台安全组放行 | 云厂商托管 | 在安全组规则里放行 8188 入站 |
其中SSH 本地端口转发对新手最友好，一条命令即可，不需要任何额外工具。
⚠️ 安全提醒：启动参数
--listen 0.0.0.0表示服务不做来源限制。如果映射到公网，务必在转发/穿透层加访问控制（token、基础认证或防火墙只放行特定 IP），不要把服务直接暴露到公网。
一键验证：确认服务已就绪
映射前先在服务器上确认服务状态，避免白忙活：
./scripts/start-comfyui-dual-npu.sh status # 应显示 running pid=… port=8188 curl -s http://127.0.0.1:8188/system_stats | head # 能看到 NPU 设备信息即正常双卡部署细节（文本编码器在 npu:1、扩散模型在 npu:0）可参考 dual-npu-deployment.md。
排查清单：映射后打不开怎么办？
| 症状 | 排查方法 |
|---|---|
| 映射后打不开页面 | 先跑start-comfyui-dual-npu.sh status确认服务在跑 |
| 服务器本机通、远端不通 | 检查转发配置和防火墙/安全组是否放行 8188 |
| 下载 404 | /view只认文件名 basename，type=output+subfolder=video必须写对 |
| 能打开 UI 但视频空白 | ls <仓库>/output/video/确认文件存在，确认前端后端同源同端口 |
更完整的 API 调用与输入输出说明见 usage.md，远程访问专项文档见 port-forward-and-download.md。
常见问题（FAQ）
Q：能不能不映射端口，直接在服务器上下载再拷出来？可以，SSH 登录服务器后从output/video/拷贝。但每次生成都要登录操作，不如端口映射后浏览器里点一下方便。
Q：8188 端口被占用了怎么办？启动时指定COMFY_PORT=8189换一个端口，映射时同步改成本地转发的目标端口即可，其余步骤不变。
Q：远程访问和下载视频会影响 NPU 上的生成任务吗？不会。/view只是读取已写好的 MP4 文件，生成任务在 NPU 上独立运行，二者互不干扰。
✅ 小结：记住三件事——只映射 8188、视频在
output/video/、/view端点是下载万能钥匙。掌握这三点，远程访问 NPU 服务器并下载视频就不再是难题。
【免费下载链接】minimax-h3-int8项目地址: https://ai.gitcode.com/xujiashuai/minimax-h3-int8
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
