常见问题
安装与运行
Q: 手机端无法访问电脑的端口怎么办？
请按以下步骤排查：
- 检查服务是否运行：确认 PostForwarder 状态显示「运行中」
- 检查 IP 白名单：确保手机的 IP 地址已添加到白名单
- 检查防火墙：Windows 防火墙可能阻止了端口访问，需添加放行规则：
powershell
New-NetFirewallRule -DisplayName "PostForwarder" -Direction Inbound -Protocol TCP -LocalPort 1403 -Action Allow- 检查网络：确保手机和电脑在同一局域网内
- 检查端口：确认监听端口未被其他程序占用
Q: 如何查看手机的 IP 地址？
- Android：设置 → WLAN → 点击已连接的网络 → 查看 IP 地址
- iOS：设置 → 无线局域网 → 点击已连接网络右侧的 ⓘ → 查看 IP 地址
Q: 程序关闭后服务还在运行吗？
关闭窗口只是最小化到系统托盘，服务会继续在后台运行。要完全退出程序，请右键托盘图标选择「退出程序」。
配置
Q: 白名单留空会怎样？
白名单留空表示全部禁止，所有请求都会返回 403 Forbidden。请务必添加手机 IP。
Q: 修改端口后需要重启服务吗？
是的。服务运行时端口输入框会被禁用，需要先停止服务，修改端口后再重新启动。
Q: 转发目标地址可以修改吗？
不可以。转发目标 http://127.0.0.1:47300/api/activities 是硬编码的，不支持在界面修改。如需修改，请修改源码中的 FORWARD_HOST、FORWARD_PORT、FORWARD_PATH 常量后重新打包。
Q: 配置保存在哪里？
配置保存在 Windows 注册表 HKCU\Software\NSDPRO\PostForwarder 中，不产生配置文件。卸载程序时如需清除配置，可手动删除该注册表项。
转发问题
Q: 日志显示「拒绝 来源 IP xxx 不在白名单」
说明来源 IP 不在白名单中。请将该 IP 添加到白名单并重启服务。
Q: 日志显示「转发失败」「502 Bad Gateway」
说明 PostForwarder 无法连接到目标服务 http://127.0.0.1:47300/api/activities。请检查：
- 目标服务是否正在运行
- 目标服务是否监听在
127.0.0.1:47300 - 目标服务的
/api/activities接口是否正常
Q: 请求体没有被正确解码怎么办？
确保请求体使用 application/x-www-form-urlencoded 格式，且包含 content= 参数。如果请求体不是该格式，程序会原样转发，不进行解码。
Q: 支持哪些 HTTP 方法？
支持 GET、POST、PUT、DELETE、PATCH 方法，但主要设计用于 POST 请求。
构建
Q: 打包后的 exe 文件很大？
PyInstaller 打包的单文件 exe 会包含 Python 运行时和所有依赖（PyQt6、requests 等），体积通常在 30-50MB 左右，属于正常现象。
Q: 杀毒软件误报怎么办？
PyInstaller 打包的 exe 有时会被杀毒软件误报为病毒。可将程序添加到杀毒软件的信任列表，或使用代码签名证书签名。