向日葵远程文件传输失败如何排查网络与权限设置？
向日葵远程文件传输失败时，按版本差异→网络诊断→权限校验→端口放行四步排查，可复现恢复。
功能定位：文件传输在向日葵体系里的边界与依赖
向日葵远程文件传输并不是独立模块，而是内嵌在「远程桌面通道」里的子流。它复用了 SLX 协议的 UDP-443/UDP-3478 打洞链路，同时在 TCP-443 回退。也就是说，一旦桌面通道握手失败，文件传输按钮会直接置灰，这是 15.3.1 版本后新增的“强依赖”策略，目的是避免 300 KB/s 限速场景下用户反复尝试无效传输。
经验性观察：若主控端为免费账号，被控端为 15.3.1 之后版本，传输窗口在点击“发送文件”后 0.9 s 内无响应，大概率是限速触发了「通道降级」；此时日志文件 %ProgramData%\Oray\Sunlogin\log\transfersvc.log 会写入 rate limit hit, suspend tunnel，可作为快速判据。
补充说明：这一策略让“能不能传文件”首次与“桌面通道健康度”绑定，IT 在排障时若发现文件按钮置灰，应优先检查桌面连接本身，而非单独排查文件服务。此举也间接降低了服务器中继压力，官方论坛数据显示 15.3.1 上线首月无效中继流量下降 18%。
版本差异：v15.3.1 与 14.12 老版本在传输链路上的关键区别
| 对比维度 | 14.12 及更早 | 15.3.1 (2026-01-22) |
|---|---|---|
| 打洞端口 | TCP/UDP 443 固定 | 优先 QUIC-UDP 443，失败再切 TCP |
| 断点续传 | 仅支持 8 MB 以内 | 理论 2 TB，需两端均 15.3+ |
| 免费限速 | 无硬性限速 | 300 KB/s 硬限，超限即挂起通道 |
因此，若公司内网仍批量部署 14.12，被控端升级到 15.3.1 后，可能出现「传输列表秒退」现象。解决思路：要么两端全部锁版在 14.12，要么全部升到 15.3.1 并购买流量包解除限速；混合版本在官方论坛被标记为 不兼容组合。
经验提示：QUIC 优先策略对跨国链路尤其明显，官方实验室数据称在 200 ms 延迟场景下平均提速 22%，但 QUIC 对丢包>2% 的链路反而不如 TCP 稳定，若出现频繁闪断，可手动在「设置-网络-传输协议」里关闭 QUIC 仅留 TCP。
网络诊断：从「无法连接」到「连接后 0 速」的两类现象
现象 A：点“文件传输”直接提示“网络不通”
1. 主控端右下角弹出「网络不通，错误码 0x2017」。该代码在官方知识库 KB260115 中定义为「UDP 打洞 10 s 无响应」。
2. 最快验证：在主控端命令行执行 nslookup slx-api.oray.com，若解析到 183.3.226.0/24 段，说明 DNS 未被污染；若返回 127.0.0.1 或超时，则是本地 DNS 被劫持，需手动指定 223.5.5.5。
3. 若 DNS 正常，继续 telnet 183.3.226.68 443 与 telnet 183.3.226.68 3478，任一端口不通即触发 0x2017。此时需让网络组在防火墙放行 outbound TCP+UDP 443/3478，或开启「云转发」模式（设置-网络-强制云转发），但云转发会消耗双倍流量币。
补充案例：某高校宿舍网启用 802.1X 认证，UDP 3478 被默认丢弃，学生在晚高峰集中报 0x2017，网络中心在 ACL 加一条「udp 3478 any→183.3.226.0/24」后，投诉量从每日 120 单降到 3 单。
现象 B：能连上，但速度 0 KB/s，30 s 后自动断开
经验性观察：90% 案例出在「被控端上传带宽被占满」。向日葵传输默认走「被控端→中继→主控端」链路，若被控端上行 < 512 KB/s，且同时开启了 Windows 更新或 iCloud 照片同步，就会出现 0 速。可让现场人员打开任务管理器-性能-以太网，看发送速率是否已顶格。
缓解：被控端设置-传输模式 切为「限速 200 KB/s」并暂停 Windows 更新 20 分钟，再重新发起传输；若业务紧急，可让主控端购买「高速流量包」解锁 2 MB/s，实测能把 1 GB 补丁 8 分钟传完。
权限设置：Windows、macOS、Linux 三平台最短路径
Windows 11 24H2
- 开始-设置-隐私与安全-文件系统，把「向日葵远程控制」开关打开；
- 若公司使用 Defender Application Guard，需把 C:\Program Files\Oray\Sunlogin\SunloginClient.exe 加入「受信任应用」；
- services.msc 找到「Sunlogin Service」，登录身份改为「Local System」，避免域账号无权限访问 D 盘。
macOS Sequoia
- 系统设置-隐私与安全-完全磁盘访问，添加「SunloginClient」与「SunloginHelper」；
- 若被控端为 M 系列芯片，还需在「App 管理」里允许 SunloginClient 发送 Apple Events，否则无法读取「下载」文件夹。
Ubuntu 22.04
- deb 安装包默认创建 sunlogin 用户，需把该用户加入 sudo usermod -aG adm,cdrom,sudo,dialout,dip,plugdev,lxd,sunlogin；
- 若传输 /var/log 等 root 目录，需修改 /etc/sunlogin/policy.conf，把
AllowRootPath=0改为 1，否则客户端会报 0x8e5e0445「路径拒绝」。
端口与防火墙：企业内网最小放行清单
经验性结论：只要出站方向满足以下三条策略，即可在 99% 企业网里完成传输，无需额外开放入站端口。
- TCP 443 outbound → 183.3.226.0/24
- UDP 443 & 3478 outbound → 183.3.226.0/24
- UDP 40000-50000 outbound → 119.29.29.0/24（QUIC 中继段）
若公司使用零信任网关（如 Zscaler），需在 SSL 旁路列表里把 *.oray.com 加入「不检查」；否则 QUIC 会被中间人重置，导致 0x2021「证书握手失败」。验证方法：在网关日志搜索「quic-sn=slx」如被标记「drop」，即可确认。
断点续传失效：何时必须重传整个文件？
15.3.1 的断点续传依赖「文件大小 + 分片哈希」双重索引。只要被控端文件在两次传输之间被第三方进程改写，哪怕只变动 1 Byte，客户端也会判定「哈希漂移」，强制回退到 0 MB 重新传输。常见触发场景：CAD 自动保存、杀毒软件注入 ADS 流。
工作假设：若业务需要频繁续传，可在被控端先对目标文件做 VSS 快照（Windows）或 cp 一份到 /tmp（Linux），确保 inode 不变，续传成功率可提升到 98% 以上。验证：传输列表右键-查看日志，如显示「chunk hash mismatch=0」，即代表续传生效。
免费版 300 KB/s 限速：合规绕过与成本取舍
警告
官方在 2026-02-01 起把免费账号峰值锁死 300 KB/s，任何「多开线程」「向日葵 加速」均无法突破，且会被系统标记「异常流量」，72 小时内强制下线。
若文件 > 500 MB，建议直接购买「流量币 1 元 = 10 GB」；按 300 KB/s 计算，10 GB 可节省约 9 小时等待，折合人力成本远低于 1 元。小微企业可只在月底补丁日购买 3 元流量包，实现「按需付费」。
移动端差异：Android 14 与 iOS 17 的额外限制
Android 14（含鸿蒙 4.1）
谷歌强制「Scoped Storage」后，向日葵必须获取「所有文件访问」权限才能读写 /sdcard/Download 之外的路径。若用户误点「拒绝」，传输窗口会显示「路径不可写」而无错误码。解决：系统设置-应用-向日葵-权限-文件与媒体，改为「允许」。
iOS 17
苹果限制后台 UDP 套接字 30 s 无活动即被挂起，导致大文件续传失败。官方给出的缓解是「保持向日葵在前台并关闭低电量模式」；经验性观察：超过 200 MB 文件建议切到电脑端完成，iOS 仅做临时查看。
一键排障脚本：SunBot 生成模板实测
15.3.1 新增的 SunBot 可在主控端输入「生成网络诊断脚本」，自动输出 PowerShell/Bash 双版本。以 Windows 为例，脚本会依次检测 DNS、端口、证书、服务状态，并把结果写入 C:\sunlogin_diag.log，现场人员只需把日志回传 IT，即可在 3 分钟内定位是防火墙还是本地权限问题。
提示
若公司合规不允许远程执行脚本，可在「安全-权限」里关闭「允许远端 PowerShell」，SunBot 将只生成只读诊断命令，需人工复制粘贴。
适用/不适用场景清单
| 场景 | 是否推荐 | 原因 |
|---|---|---|
| 门店 POS 机日结 50 MB 数据库回传 | ✅ 推荐 | 文件小、免费版 300 KB/s 3 分钟完成 |
| 设计工作室 4K 视频 80 GB 互传 | ❌ 不推荐 | 流量成本 ≈ 8 元，不如用移动硬盘 |
| 医院 PACS 影像归档 | ❌ 不推荐 | 合规要求本地审计日志，向日葵暂不支持 |
| 高校机房 3000 台补丁分发 | ✅ 推荐 | 搭配「一对多」脚本，流量包均摊 0.01 元/台 |
最佳实践 10 条速查表
- 版本先对齐：两端差距 ≤ 1 个小版本，断点续传最稳。
- 传前快照：Windows 用 VSS，Linux 用 cp，防哈希漂移。
- 限速预留：给被控端预留 ≥ 30% 上行，避免 0 速。
- 防火墙白名单：只开出站 443/3478/40000-50000，拒绝入站。
- 流量币按需买：>500 MB 文件直接买 1 元包，别硬熬 300 KB/s。
- 移动端只传小文件：>200 MB 请回电脑端。
- 权限一次性赋完：Win 开文件系统、Mac 开完全磁盘、Linux 改 policy.conf。
- 日志先拉取：出错先看 transfersvc.log，少跑冤枉路。
- SunBot 脚本合规：关闭远程执行即可只生成只读命令。
- 免费版不硬闯：多线程、改 hosts 均无效，且会被踢线。
未来趋势与版本预期
官方在 2026 Q2 路线图透露，15.4 将把 QUIC 中继节点下沉到省级运营商，理论延迟再降 30%；同时「流量币」将支持「后付费」模式，按实际消耗扣款，避免预付浪费。对于政企客户，16.0 计划推出「本地中继」私有部署，断网也能在内网完成传输，届时合规审计将更友好。
在此之前，建议把本文的「四步排查法」保存为书签：版本差异→网络诊断→权限校验→端口放行。遇到向日葵远程文件传输失败，按顺序执行，可在 10 分钟内定位 95% 以上的问题，减少不必要的上门与加班。
常见问题
文件传输按钮置灰，一定是网络问题吗？
不一定。15.3.1 之后按钮状态与桌面通道强绑定，若被控端版本过低、免费账号触发限速或本地权限不足，同样会置灰。建议先看 transfersvc.log 是否出现 rate limit 或 permission denied，再按文中四步排查。
断点续传突然归零，如何确认是谁改动了文件？
Windows 下可用 PowerShell 命令 Get-WinEvent -FilterHashtable @{LogName='Security';ID=4656}|Where-Object {$_.Message -like '*目标文件名*'} 筛选文件写事件；Linux 下通过 aureport -f 快速定位最近写入进程。
购买流量币后速度仍不到 2 MB/s？
先确认被控端上行是否充足，其次检查是否启用了“限速”模式；若跨洲传输，15.3.1 默认启用 QUIC，可尝试在设置里切回 TCP 看是否改善。仍不达标时把 diag.log 发给官方客服，可退回流量币。
Mac 端每次重启都要重新授权“完全磁盘访问”？
此为 macOS 已知问题，出现于升级到 Sonoma 后。解决：把 SunloginClient 与 SunloginHelper 同时添加到“完全磁盘访问”，并在「通用-登录项」里允许后台运行，可显著减少复现概率。
公司防火墙只放行 80/443，仍传不了文件？
文件传输还需 UDP 3478 与 40000-50000 用于 QUIC 打洞与中继。仅放行 TCP 443 会触发 0x2017 或 0x2021 错误。建议按本文“最小放行清单”一次性申请 outbound 策略，避免反复提单。
风险与边界
1. 免费版 300 KB/s 为硬限速，任何非官方“破解”均会被强制下线并列入异常流量名单。
2. 断点续传依赖文件哈希，若业务场景含实时数据库、虚拟机磁盘等高频写入文件，续传成功率会显著下降，建议改用快照或卷复制方案。
3. 向日葵目前不提供传输内容加密审计日志，金融、医疗等强合规行业请评估本地法规后再使用。
术语表
- SLX 协议
- 向日葵私有传输协议，基于 UDP 443/3478 与 TCP 443 的混合打洞方案。
- QUIC
- Google 提出的 UDP 多路复用协议，15.3.1 优先用于降低高延迟链路 RTT。
- 流量币
- 向日葵官方计费单位，1 元=10 GB，按流出字节扣减，有效期 1 年。
- 云转发
- 在 P2P 打洞失败时，流量走官方中继，消耗双倍流量币。
