魔方云批量更换IP工具

一、这个软件是干什么的？

本软件帮你把两件原本很麻烦的事情变成”点点鼠标”就能完成：

批量更换IP（魔方云）：一次给一台或多台云服务器更换公网 IP。

拉取信息（魔方财务）：按 IP 段把魔方财务系统里的主机信息同步一遍。

为什么要配套使用？ 在魔方云给服务器换完 IP 后，魔方云和魔方财务两个系统的数据就不同步了。 这时需要到本软件的「拉取信息」页，按 IP 段同步一下，两边数据才会一致。

简单记：先在「批量更换IP」页换 IP，再到「拉取信息」页同步，一套流程就完成了。

⚠️ 重要提醒：更换 IP 是真实操作，会真的给服务器加新 IP、删旧 IP。 建议第一次使用时，先勾选一台服务器测试，确认没问题后再批量操作。

二、怎么拿到软件、怎么打开？

软件是一个单独的 exe 文件：魔方云批量更换IP.exe（约 16MB）。

双击它就能打开，不需要安装 Python，也不需要任何其他环境。

打开后会看到一个深色主题的窗口，标题是「魔方云批量更换IP工具」。

窗口里有 4 个标签页，从上到下依次是： 批量更换IP、拉取信息、使用帮助、关于和反馈。

第一次打开时请注意：

首次启动会慢一些（大约 5～15 秒），这是正常现象，请耐心等待，不要以为死机了。

部分杀毒软件可能会误报，属于正常情况，建议把 exe 加入白名单。

软件会在它所在的文件夹里自动生成一个 config.json 文件，用来记住你勾选的登录信息（详见后面的”常见问题”）。

三、开始之前：先弄明白”登录信息”是什么？

软件需要两种登录凭证，它们不是账号密码，而是浏览器登录后台后，从开发者工具里复制出来的：

名称 是什么 在哪里拿

access-token 一串字母数字，相当于一把”钥匙” 浏览器 F12 → 网络 → 请求标头里

Cookie 一段以 PHPSESSID= 开头的信息，相当于”登录状态” 浏览器 F12 → 网络 → 请求标头里

请注意：

魔方云和魔方财务是两个不同的后台，各自的 Cookie 不同，要分别到各自的后台用 F12 获取。

这两个凭证等同于你的登录身份，不要截图、不要发给别人。

获取方法不会也没关系，软件自带的「使用帮助」标签页里有完整的图文教程（见第六节），下面先讲一遍核心步骤。

四、如何获取登录信息（重点）

以魔方云后台为例，一共 6 步：

登录魔方云后台，复制浏览器地址栏里的完整域名和路径（例如 https://example.com/baidu）。

按键盘上的 F12 键（笔记本可能需要按 Fn + F12），浏览器右侧或下方会弹出开发者工具。

点击开发者工具顶部的「网络 Network」标签。

在后台页面点一下「云服务器」之类的菜单，触发请求；在请求列表里找到带 /v1/ 的请求（例如 /v1/clouds），点击它。

在右侧「标头 Headers」面板里找到 access-token 这一行，复制它后面的值。

在同一个面板里找到 Cookie 这一行，复制整行内容（通常以 PHPSESSID= 开头）。

补充说明：

1、域名和路径的区分

图片[1]-魔方云批量更换IP工具 · 新手使用教程-朝晞小屋

2、如何获取access-token、Cookie

图片[2]-魔方云批量更换IP工具 · 新手使用教程-朝晞小屋

拿到后，回到软件，把域名、access-token、Cookie 填到对应输入框里就行了。

小提示：Cookie 输入框写着”不带PHPSESSID=”，意思是只填 PHPSESSID= 后面的那串值也可以； 但软件也兼容直接粘贴完整的 Cookie 头，两种填法都能用（以软件实际表现为准）。

拉取信息页的 Cookie 要去魔方财务后台用同样的方法获取，不能直接拿魔方云的来用。

五、标签页一：批量更换IP（魔方云）

图片[3]-魔方云批量更换IP工具 · 新手使用教程-朝晞小屋

这是软件最核心的功能页。操作顺序如下：

第 1 步：填写 4 个输入框

输入框 必填？ 填什么

后台域名与路径 必填 魔方云后台完整域名和路径，例如 https://example.com/baidu

IP段（1.1.1. ） 可选 例如 1.1.1. 或单个 IP，用来筛选服务器；留空 = 匹配全部（这里填写的IP段是需要更换的IP段）

access-token 必填 按第四节第 5 步复制来的值

Cookie（不带PHPSESSID=） 必填 按第四节第 6 步复制来的内容（或只填 PHPSESSID 后面的值）

第 2 步：（可选）勾选「记住登录信息」

勾选后，下次打开软件会自动填好以上内容，不用每次重新复制。

不勾选就不保存。

注意：这些信息是明文存在本机 config.json 里的，请不要把 config.json 发给别人。

第 3 步：点「测试连接」

作用：检查你填的 token 和 Cookie 有没有效。

成功会有提示；失败请检查是否复制完整，或看右侧日志里的具体报错。

第 4 步：点「获取服务器列表」

软件会按你填的 IP 段去搜索服务器，把结果显示在下面的表格里。

表格有 5 列：选择 / ID / 主机名 / IP地址 / 状态。

第 5 步：勾选要更换的服务器

点击表格第一列的 ☐ / ☑，就能勾选或取消勾选某台服务器。

也可以使用「全选」或「反选」按钮快速选择。

表格下方会显示「共 X 台，已选择 X 台」，方便你核对。

第 6 步：点红色按钮「开始更换所选服务器IP」

点击后会弹出确认框，列出你选中的前 20 台服务器，请仔细核对后再确认。

确认后开始逐台更换，每台服务器的流程是：

获取这台服务器的信息；

找到该节点上的一个空闲 IP；

添加新 IP；

等 5 秒让新 IP 生效；

删除旧 IP；

每台之间间隔 3 秒。

你可以通过进度条和状态文字看当前进度（格式：已处理/总数）。

全部完成后会弹出完成提示，并自动刷新服务器列表，此时列表里显示的就是新 IP。

第 7 步：想看详细过程？点「日志」按钮

「日志」按钮在这一页的操作行里，点击后右侧会展开日志侧边栏。

日志里会记录每一步做了什么、成功还是失败，方便排查问题。

再点一次「日志」，或点侧边栏顶部的「收起」，可以隐藏侧边栏。

日志在隐藏时也会照常记录，展开后能看到全部历史并自动滚动到最底部。

侧边栏里还有「清空日志」按钮，可以一键清空。

⚠️ 再次提醒：这一步是真实修改操作。强烈建议先勾选一台服务器试跑一遍，确认没问题后再批量更换。

六、标签页二：拉取信息（魔方财务）

图片[4]-魔方云批量更换IP工具 · 新手使用教程-朝晞小屋

在魔方云换完 IP 后，回到这个标签页，把魔方财务的主机信息同步一下。

第 1 步：填写输入框

输入框 必填？ 填什么

基础URL 必填 魔方财务站点的根地址，例如 https://www.example.com

后台路径 默认 财务后台登录路径，默认是 ZX123；留空会自动使用 ZX123

Cookie（不带PHPSESSID=） 必填 魔方财务后台的 Cookie（在魔方财务后台 F12 获取，不是魔方云的）

IP段（1.1.1. ） 必填 例如 1.1.1 或完整 IP，按这个 IP 段去找主机（这里填写的IP段是需要更换的IP段）

第 2 步：按需调整高级选项

最大获取数量：默认 1000，即一次最多拉取多少台主机。

请求间隔(秒)：默认 0.1，每台主机同步前的等待间隔，避免请求过快。

第 3 步：（可选）勾选「记住登录信息」

和批量更换页一样，勾选后保存到本机 config.json（这一页的配置是独立保存的）。

第 4 步：点「测试连接」

会按你填的 IP 段先拉取 1 台验证配置是否正确。

第 5 步：点「开始拉取信息」

软件会按 IP 段找到主机列表，然后逐台触发同步。

每台的结果会显示在结果表格里，表格有 4 列：序号 / 主机ID / 状态(成功/失败) / 返回消息。

进度条和状态文字会显示当前进度。

第 6 步：查看结果和保存文件

全部结束后会弹窗统计成功/失败的数量。

同时结果会自动保存为一个 JSON 文件：sync_results_{IP段}_{时间戳}.json，保存在程序所在目录（exe 同目录）。

保存路径会写进日志里，找不到文件时点「日志」按钮查看具体路径。

小贴士：换完 IP 后，回来用相同/对应的 IP 段执行一次拉取，两边数据就同步了。

七、标签页三：使用帮助

这个标签页是软件内置的图文教程，专门教新手如何获取 access-token 和 Cookie。

一共 6 步，每步都有文字说明和一张示意图：

登录魔方云后台，复制地址栏完整域名与路径；

按 F12 打开开发者工具，点「网络 Network」；

在请求列表中找到带 /v1/ 或 api 的请求（如 /v1/clouds）；

在「标头 Headers」里复制 access-token 的值；

复制 Cookie（一整行即可）；

回到软件填入 4 项内容，点「测试连接」或「获取服务器列表」。

页面底部的橙色提示也请留意：access-token 和 Cookie 属于账号凭据，请勿截图或分享给他人。

说明：示意图是软件绘制的示意图，不是真实截图，请以实际操作界面为准。

八、标签页四：关于和反馈

这个页面包含作者信息和联系方式：

作者：朝晞科技、朝晞云；软件版本 v1.0.0。

招商卡片：「朝晞云 · 诚招代理，欢迎同行咨询」。

官网：cloud.zxiyun.com（可以点击打开，也可以一键复制网址）。

QQ交流群：551699419（可一键复制群号）；如果群已满或失效，可以加群主 QQ：2604140139。

卖点：免预存对接多种货源；不用多家上游充值，无资金压力；所有售后只需找「朝晞云」。

反馈卡片：使用中遇到问题、有改进建议或想合作，都可以通过 QQ 群或群主 QQ 联系。

九、常见问题（FAQ）

Q1：第一次打开软件很慢，是不是坏了？ 不是。exe 是单文件打包，首次启动需要解压到临时目录，等 5～15 秒属正常现象。

Q2：杀毒软件报毒/拦截怎么办？ PyInstaller 打包的程序可能被部分杀毒软件误报。建议将 exe 加入杀毒软件白名单，然后正常使用。

Q3：「测试连接」失败怎么办？ 先检查四项内容是否复制完整（尤其是 access-token 和 Cookie 不能缺字符、不能多空格）；再确认填的是不是对应后台的凭据；也可以点「日志」按钮，看右侧日志里的具体报错信息。

Q4：勾选了很多台，能改吗？ 可以。点击表格第一列的 ☐/☑ 随时取消勾选，或用「全选」「反选」调整；开始前会弹确认框，核对完再确认。

Q5：日志侧边栏在哪？为什么看不到？ 日志默认是隐藏的。在「批量更换IP」页的操作行点「日志」按钮就会展开；再点一次或点侧边栏顶部的「收起」就隐藏。日志隐藏期间也会照常记录。

Q6：config.json 是什么？会泄露吗？ 它是软件自动生成的配置文件，用来记住你勾选过的登录信息（域名、token、Cookie 等）。这些内容以明文保存，只存在本机程序目录里。请不要把这个文件发给别人，也不要轻易删除（删了只是下次要重新填一遍）。

Q7：魔方云的 Cookie 能用到拉取信息页吗？ 不能。两个系统是独立后台，Cookie 不一样，拉取信息页需要去魔方财务后台 F12 获取。

Q8：更换 IP 后为什么还要去拉取信息？ 因为换 IP 只改了魔方云这边，魔方财务还不知道。用「拉取信息」页按 IP 段同步一次，两个系统数据才会一致。

Q9：结果 JSON 文件保存到哪里了？ 保存在程序所在目录（exe 同目录），文件名是 sync_results_{IP段}_{时间戳}.json。具体路径会写入日志，点「日志」按钮查看。

Q10：是否可以更换指定的IP段？如果想给客户更换指定的IP段，只需要在更换前将其他可用的IP段禁掉就行，只留下指定IP段的所有IP即可 。

十、完整流程速查（照着做就行）

第一次使用：

双击打开 exe，等 5～15 秒；

在「批量更换IP」页填入后台域名、IP段（可留空）、access-token、Cookie；

点「测试连接」确认没问题 → 点「获取服务器列表」；

先只勾选一台服务器 → 点「开始更换所选服务器IP」→ 确认；

观察进度条和日志，确认更换成功后，再正式批量操作。

日常使用：

打开软件，「批量更换IP」页填写（勾了记住登录信息的话会自动填好）；

获取列表 → 勾选要换的服务器 → 开始更换 → 等待完成；

切到「拉取信息」页，填基础URL、后台路径（默认 ZX123）、魔方财务 Cookie、IP段；

点「测试连接」→ 点「开始拉取信息」→ 等待同步完成；

看结果表确认成功，需要留档的话去程序目录找 sync_results_*.json。