向日葵端口映射功能指南

1、功能定位

TCP 端口映射功能用于在主控端与被控端之间建立安全、稳定的 TCP 通道，将被控设备上的本地端口映射到主控设备，使主控能够像访问本机服务一样访问远端服务。

2、适用范围

适用人群

1、开发者、测试人员、运维工程师
2、远程管理内网应用、数据库或后台系统的团队
3、需要绕过网络限制、跨环境访问服务的用户

3、适用场景

1、远程调试 API、后台页面、本地 Web 服务
2、访问被控设备上的数据库（如 MySQL、Redis）
3、远程访问家庭服务器、NAS、Docker 服务

4、前置条件

使用前请确认以下条件：

1、主控需更新至 V16.1.2 及以上版本
2、主控端与被控端需使用同一账号登录
3、当前被控仅支持 Windows、macOS，其余系统正在适配中

5、操作步骤

步骤1 选择目标设备

1、在“设备列表”选择需要映射的被控设备
2、在右侧操作面板里里，点击端口映射按钮进入配置。

步骤2 进入端口映射设置

1、点击“端口映射”后，弹出“端口映射设置”窗口
2、填写映射信息，如本地端口、映射主机、映射端口
3、设置成功后，保持“启用”开关打开即可

步骤3 启动映射

1、填写完成后，点击“开始映射”
2、通过访问校验后，向日葵将自动建立主控与被控设备之间的安全TCP通道

6、常见问题 FAQ

Q1：本地端口填写什么？
本地端口是你在主控设备上用来访问服务的端口。只要不被占用，选择任意合法端口即可，如 8080、9000。

Q3：提示“端口映射失败”怎么办？
代表该端口重复或当前已被使用，换一个未占用的端口即可，例如把 8080 改成 8081。

Q4：映射后访问不到服务？
可检查以下内容：

1、被控设备上的服务是否正常运行
2、映射端口是否填写正确
3、服务是否只监听 IPv6 或特殊地址（建议监听 0.0.0.0 或 127.0.0.1）
4、本地端口是否被其他应用占用

Q5：能一次创建多条映射吗？
可以，点击“添加映射规则”即可设置。

Q7：是否支持 UDP 映射？
当前仅支持 TCP 映射，后续将根据需求规划更多协议支持。

Q8：是否支持 Linux 被控端？
目前仅支持 Windows 和 macOS（需升级至 16.1.2 及以上版本)，被控端 Linux 系统正在适配中。