Steam 网页代理：安装后的设置与使用
使用前准备
使用前，你需要先有一个已经可用的 SOCKS5 或 HTTP 代理。 Steam 网页代理只是复用这个代理，帮 Steam 分配哪些连接走代理、哪些直接联网。本工具不提供 VPN 服务、代理节点、订阅或账号；没有现成代理，单独安装它也无法获得代理连接。
需要准备：
- 已安装 Steam 的 Windows 10/11 x64 电脑，以及 .NET Framework 4.8。
- 一个已经能正常使用的代理，提供 SOCKS5 或 HTTP 连接；目前不支持 SOCKS4 和用户名密码认证。
- 该代理的地址、协议和端口。请在原来的代理软件里查找，8899、8898 只是本工具的默认示例。
先确认原来的代理能正常访问目标网站，再来填写本工具。没有代理，或原代理已经断开时，本工具无法替它建立一条新的代理线路。
分流后怎么用流量
默认只有 Steam 网页进程使用你填写的代理，游戏下载直接连接 CDN。可选的“Steam 会话代理”还会代理 CM 登录连接，但下载仍直连。目的是减少代理流量消耗，避免大体积游戏下载占用代理额度。
网页图片、视频和其他 WebHelper 请求也会使用代理；具体流量随使用情况变化。若同时开启其他全局 VPN 或 TUN，下载还可能受这些软件影响。
本工具不依赖 Clash。内置 Mihomo 只负责本机转发和域名识别，启用时自动运行；它不提供 VPN 服务或远程节点。
选择版本
- 安装版：运行
SteamWebProxy-Setup-1.3.0.exe，点击“安装”。默认创建桌面快捷方式，开始菜单和 Windows 应用管理中也有入口。 - 便携版：直接打开
SteamWebProxy.exe。程序文件可单独移动；设置和组件缓存仍存放在用户目录，并非不写磁盘的纯绿色模式。
两个版本都不附带代理节点。先运行已有的代理软件，不必开启系统代理或 TUN。
安装包把程序放到当前用户的 %LOCALAPPDATA%\Programs\SteamWebProxy，不会添加开机启动项。便携 EXE 与安装版功能一致，二选一即可。不要同时运行两份主窗口。
填写代理
| 设置 | 填写示例 |
|---|---|
| 协议 | SOCKS5 或 HTTP |
| 地址 | 127.0.0.1，不要填写 http:// 或附加端口 |
| SOCKS5 端口 | 例如 8899，可自由修改 |
| HTTP 端口 | 例如 8898，可自由修改 |
| Steam 程序 | 自动识别或手选 steam.exe |
| 本机转发端口 | 默认 18899；只有发生端口占用时才需修改 |
只使用当前所选协议的端口，不需要两个端口同时存在。不支持需要用户名和密码的代理。
例一：使用 SOCKS5 8899
如果代理软件明确显示 SOCKS5 监听于 127.0.0.1:8899，在本工具中选择 SOCKS5，地址填写 127.0.0.1，SOCKS5 端口填写 8899。HTTP 端口此时不参与连接，可以保留原值。
例二：使用 HTTP 7890
如果代理软件提供的 HTTP 端口是 7890，就选择 HTTP，地址填写 127.0.0.1，HTTP 端口改为 7890。不需要为了配合本工具去修改代理软件的端口。
HTTP 代理也可以承载 HTTPS 网页连接，因此这里的“HTTP”并不表示只能打开 http:// 网站。但 HTTP 上游不提供 SOCKS5 UDP 转发能力，语音和其他 UDP 功能不属于当前验收范围。
上游端口与本机转发端口
上游端口由你的代理软件提供；“本机转发端口”由本工具自己监听，两者用途不同。例如上游 SOCKS5 是 8899，本机转发是 18899，不要将两个字段都填成 8899。
本机转发端口只要没有被其他程序占用即可。在项目原型迁移的这台机器上使用过 18898，是为了避开旧实例，普通新用户不需要照抄这个值。
开始与结束
- 点击“检测代理”。通过后说明商店和社区可以经过所填代理访问。
- 点击“启用并启动 Steam”。首次缺少 ProxiFyre 时自动安装；管理员提示只用于安装和设置进程规则。
- 启用后窗口关闭会转入托盘。代理软件和本工具都应保持运行。
- 点击“关闭代理”使 Steam 恢复直连，或从托盘选择“退出并关闭代理”。关闭规则也需要管理员授权。
如果 Steam 已经打开，启用规则会影响新建连接；遇到旧页面仍报错，可重新打开页面或自行正常重启 Steam。本工具不会强制终止游戏或正在下载的 Steam。
启用期间不允许修改设置；需要切换端口时先关闭代理，再修改并重新启用。每次启用读取保存的设置，无需重新填写。
如何判断是否正常
“检测代理”成功，表示本工具能够经所填代理访问商店和社区。这个步骤使用临时转发，不会替你配置 Steam 网页进程规则，也不等于游戏联机测试通过。
点击“启用并启动 Steam”后，状态应显示“已启用”，并列出所选协议、地址和端口。然后在 Steam 中实际打开商店、社区，检查文字、图片和页面操作是否正常。
如还要核对下载是否直连，可在已有下载任务中观察连接归属：页面代理流量与 steam.exe 的 CDN 连接应分别检查。单看下载速度快慢不足以证明直连，维护人员可参照验证文章。不熟悉连接工具时，优先使用本工具既定规则，无需修改 Steam 文件或防火墙。
其他软件如另开了全局 VPN、系统代理或 TUN，仍可能影响实际出口。本工具不会替你关闭它们，也不能越过这些网络设置保证物理线路直连。
日常使用与切换
| 场景 | 操作 |
|---|---|
| 重启电脑后继续用 | 先启动代理软件，再打开本工具并启用 |
| 想临时恢复直连 | 点击“关闭代理” |
| 想更换节点 | 在自己的代理软件中切换节点；本工具仍连接同一个本机端口 |
| 想更换代理协议或端口 | 先关闭代理，再改字段、检测、重新启用 |
| 只是不想看到窗口 | 关闭主窗口，让它在托盘继续运行 |
| 完整退出 | 托盘菜单选择“退出并关闭代理”，允许管理员提示 |
启用时关闭主窗口会继续转发。不要把“窗口看不见了”当成已经关闭代理；也不要通过任务管理器强行结束本工具或专用转发。若意外结束后页面不通，重新打开并启用；需要恢复直连时使用正式关闭流程。
常见情况
| 提示/现象 | 处理 |
|---|---|
| 无法连接代理端口 | 确认代理软件已启动，填写的协议和端口正确 |
| 本机转发端口被占用 | 更换“本机转发端口”，不要结束不认识的程序 |
| 已有 ProxiFyre 自定义配置 | 本程序不会覆盖其他规则；先自行备份和整理现有 ProxiFyre 配置 |
| Windows 提示未知发布者 | 本版未签名，可先与 SHA256SUMS.json 核对文件 SHA-256 |
| 第一次安装依赖失败 | 官方驱动安装器需要访问上游下载源，检查网络并查看安装日志；本包不是完全离线依赖包 |
| 安装器提示需要重启 | 正常重启 Windows 后重新启用，不会由本工具自动重启 |
| 游戏联机仍失败或延迟高 | 游戏进程未经过此代理；需另行诊断游戏服务器/P2P/线路 |
检测通过，但 Steam 页面仍报错
先确认是否已经点击“启用并启动 Steam”，以及状态是否显示已启用。之后重新打开报错页面，让它建立新连接。若没有变化，在没有重要游戏或下载任务时正常退出并重新打开 Steam。
仍不通时，保留错误文字、发生时间、所用协议及端口，查看本工具日志。不要同时更改系统 DNS、hosts、节点、端口和 Steam 参数，否则很难判断是哪一步产生作用。详细排查思路见DNS 排障案例。
管理员提示被取消
启用或关闭没有完成时，以窗口状态和日志为准，重新点击对应操作。关闭失败时，程序会保留转发实例以供重试，不应直接结束进程来替代关闭。
Steam 路径找不到
点击“选择…”定位 Steam 安装目录里的 steam.exe，不要选择游戏的 EXE。若目录内没有对应 WebHelper，先让 Steam 完成客户端安装或更新，再重试。
数据与卸载
用户设置和日志：%LOCALAPPDATA%\SteamWebProxy。配置备份和安装日志：%PROGRAMDATA%\SteamWebProxy。日志不保存 Steam 登录资料、Cookie 或代理订阅。
| 位置 | 保存内容 |
|---|---|
%LOCALAPPDATA%\SteamWebProxy\settings.json |
代理协议、地址、端口及 Steam 路径 |
%LOCALAPPDATA%\SteamWebProxy\app.log |
应用错误和运行诊断信息 |
%LOCALAPPDATA%\SteamWebProxy\tools |
从 EXE 解出的固定版本组件 |
%LOCALAPPDATA%\SteamWebProxy\relay |
专用转发运行配置 |
%PROGRAMDATA%\SteamWebProxy |
受保护的规则备份及依赖安装日志 |
反馈问题时通常只需错误信息、时间和相关日志片段。日志可能包含本机路径或网络地址，分享前检查这些内容，不必提交整个用户目录或 Steam 登录文件。
安装版先从托盘退出，再在 Windows“已安装的应用”里卸载。用户设置以及共享 ProxiFyre、Windows Packet Filter 驱动会保留。确定没有其他程序使用时，可在 Windows 应用管理中单独卸载这些依赖。
升级前后
升级前先从托盘退出旧版，使进程规则正常关闭，再运行新安装包；便携用户也应先退出再替换 EXE。用户设置保存在固定用户目录，不随 EXE 路径变化而自动消失。
升级后先核对协议、端口和 Steam 路径，再做一次检测并启用。不要把本机日志、规则备份或已安装组件缓存当作安装包转发给别人；分享程序应使用项目 releases/ 中的正式交付文件。
可选：Steam 会话代理
1.3.0 包位于 releases/1.3.0/，默认保持仅代理网页。需要检查已入库游戏安装/启动的地区提示时，可在停止状态勾选“Steam 会话代理（实验）”，会话端口默认 18897。
此模式将 steam.exe 的 TCP 连接送入独立本地入口，仅对 CM 域名及 27017–27050 目标端口使用上游，其他连接默认直接出站。网页端口、会话端口和本机上游端口不得相同。它不代理游戏进程，也不修改账号国家或授权。
先正常退出 Steam，再点击启用；程序用 -websocket 参数启动客户端，让 CM 登录使用被接管的 TCP 连接。若 Steam 已在运行，请正常退出，再关闭并重新启用本工具。不要强制结束正在运行的游戏或下载。软件不会自动强制重启 Steam，也不承诺解除地区限制；若原因为账号或发行授权，改变网络出口可能无效。
如果上游是 Clash 规则模式，确认 steamserver.net 使用目标代理策略，不能仍命中 DIRECT。下载域名仍保留直连。本工具不会自动改写上游规则；填写代理端口本身不保证该连接最后使用代理节点。
关闭此选项并重新启用后恢复网页模式；客户端已有连接仍需正常重连才能验证。规则细节与实测状态见会话代理调查。
网站入口
窗口底部的“更多实用工具与文章 · ccalex.cc”可打开作者网站。点击后由默认浏览器打开，方便查看其他项目与文章。
在工具里更新（1.2.0 起）
网站链接旁有“检查更新”按钮和“自动检查更新”开关。默认在启动时、之后每六小时检查一次；有新版时自动下载，校验完成后按钮变为“安装更新”。点击并确认后，工具会正常关闭代理、退出旧版本、替换文件并重新打开。代理设置保留，更新后请重新点击启用。
- 取消勾选“自动检查更新”：停止本次检查或下载，并记住关闭选择；手动检查仍可用。
- 点击“停止下载”：只取消本次下载，自动检查开关保持原样。
- 下载失败、超时或校验失败：保留原版本，可重新检查更新。
- 便携版原地替换，安装版保留安装位置；程序所在目录需要当前用户可写。
1.1.1 及更旧版本需要先手动安装一次 1.2.0，之后才能使用工具内更新。
更新清单与安装包从 https://ccalex.cc/ 直接获取，不通过 Steam 专用代理。程序检查下载地址、文件大小、SHA-256 和安装包版本；不会在后台未经确认替换正在运行的程序。
离线启动 Steam（1.3.0）
- 先在线登录 Steam 并记住登录状态，完成游戏下载与更新，至少正常启动一次要玩的游戏。
- 保存游戏进度并关闭游戏，在工具中点击“离线启动 Steam”。Steam 正在运行时，会先询问是否正常退出；不会强制结束进程。
- 程序关闭本工具代理，为当前保存登录的账号设置离线启动偏好，再打开 Steam。如果 Steam 显示确认框，选择离线模式。
- 恢复联网时点击“恢复在线启动”。需要代理时，再点击“启用并启动 Steam”。
两个入口不要求上游代理已经启动。当前账号通过 Steam 的最近登录标记或本机自动登录账号确定；无法唯一确定、没有记住登录或文件格式异常时，停止操作并提示原因。
这里只调整当前账号的 WantsOfflineMode。原配置先备份，再原子替换；备份位于 Steam/config/loginusers.vdf.swproxy-时间-随机标识.bak，含账号资料，请勿公开上传。程序不改写登录凭据，不关闭 Windows 网络，不屏蔽授权服务器。
Steam 家庭库中支持共享且能离线运行的游戏，可以按 Steam 的规则离线游玩；本工具不会增加游戏授权或共享副本。需要联网验证、第三方启动器或联网游玩的游戏可能不可用。离线期间云存档不同步，恢复联网时请留意存档冲突。
参考：Steam 离线模式、Steam 家庭说明。