魔方云批量更换IP工具 · 新手使用教程

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

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

1. 批量更换IP（魔方云）：一次给一台或多台云服务器更换公网 IP。
2. 拉取信息（魔方财务）：按 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 步：

1. 登录魔方云后台，复制浏览器地址栏里的完整域名和路径（例如 https://example.com/baidu）。
2. 按键盘上的 F12 键（笔记本可能需要按 Fn + F12），浏览器右侧或下方会弹出开发者工具。
3. 点击开发者工具顶部的「网络 Network」标签。
4. 在后台页面点一下「云服务器」之类的菜单，触发请求；在请求列表里找到带 /v1/ 的请求（例如 /v1/clouds），点击它。
5. 在右侧「标头 Headers」面板里找到 access-token 这一行，复制它后面的值。
6. 在同一个面板里找到 Cookie 这一行，复制整行内容（通常以 PHPSESSID= 开头）。

补充说明：

1、域名和路径的区分

2、如何获取access-token、Cookie

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

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

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

---

五、标签页一：批量更换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 台服务器，请仔细核对后再确认。
• 确认后开始逐台更换，每台服务器的流程是：
  1. 获取这台服务器的信息；
  2. 找到该节点上的一个空闲 IP；
  3. 添加新 IP；
  4. 等 5 秒让新 IP 生效；
  5. 删除旧 IP；
  6. 每台之间间隔 3 秒。
• 你可以通过进度条和状态文字看当前进度（格式：已处理/总数）。
• 全部完成后会弹出完成提示，并自动刷新服务器列表，此时列表里显示的就是新 IP。

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

• 「日志」按钮在这一页的操作行里，点击后右侧会展开日志侧边栏。
• 日志里会记录每一步做了什么、成功还是失败，方便排查问题。
• 再点一次「日志」，或点侧边栏顶部的「收起」，可以隐藏侧边栏。
• 日志在隐藏时也会照常记录，展开后能看到全部历史并自动滚动到最底部。
• 侧边栏里还有「清空日志」按钮，可以一键清空。

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

---

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

在魔方云换完 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 步，每步都有文字说明和一张示意图：
  1. 登录魔方云后台，复制地址栏完整域名与路径；
  2. 按 F12 打开开发者工具，点「网络 Network」；
  3. 在请求列表中找到带 /v1/ 或 api 的请求（如 /v1/clouds）；
  4. 在「标头 Headers」里复制 access-token 的值；
  5. 复制 Cookie（一整行即可）；
  6. 回到软件填入 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即可 。

---

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

第一次使用：

1. 双击打开 exe，等 5～15 秒；
2. 在「批量更换IP」页填入后台域名、IP段（可留空）、access-token、Cookie；
3. 点「测试连接」确认没问题 → 点「获取服务器列表」；
4. 先只勾选一台服务器 → 点「开始更换所选服务器IP」→ 确认；
5. 观察进度条和日志，确认更换成功后，再正式批量操作。

日常使用：

1. 打开软件，「批量更换IP」页填写（勾了记住登录信息的话会自动填好）；
2. 获取列表 → 勾选要换的服务器 → 开始更换 → 等待完成；
3. 切到「拉取信息」页，填基础URL、后台路径（默认 ZX123）、魔方财务 Cookie、IP段；
4. 点「测试连接」→ 点「开始拉取信息」→ 等待同步完成；
5. 看结果表确认成功，需要留档的话去程序目录找 sync_results_*.json。

遇到不懂的，先看「使用帮助」标签页，再有问题就去「关于和反馈」页联系群主或进 QQ 群（551699419）反馈。

最后再强调一遍：更换 IP 是真实操作，批量前务必先用一台服务器测试；登录凭据不要外传。