NodeCloakDOCUMENTATION
桌面端指南官网 GitHub
NodeCloak›文档
NODECLOAK · USER GUIDE

每个用途,
一个独立空间。

在同一台设备上管理 Chrome、Edge 和 Firefox 副本。为每个用途设置独立的浏览数据、代理和环境,再按需同步或分享。

研究、购物和个人用途的浏览器副本各自保存浏览数据、代理和指纹设置
01 QUICK START

五分钟开始使用

NodeCloak 为不同用途建立各自独立的浏览器空间。先安装浏览器,再创建一个副本并启动。

1

安装 NodeCloak 与浏览器

从 官网下载桌面应用。Chrome、Edge 或 Firefox 需要先安装在电脑上,NodeCloak 会检测可用浏览器。

2

新建浏览器副本

打开左侧「浏览器副本」,选择「新建副本」,填写名称并选择浏览器。可以为不同用途分别创建副本。

3

设置代理与启动页

按需要选择系统代理、直连或单独填写代理地址。也可以设置启动网址、标签和备注;首次使用可先检测代理连接。

4

启动并登录网站

点击「启动」,在新打开的独立浏览器窗口中正常访问网站和登录。每个副本单独保存网站数据。

i
沿用日常浏览器?
NodeCloak 为副本准备独立的数据目录。首次启动时,网站需要在这个副本中重新登录。
02 PROFILES

管理浏览器副本

副本承载一组独立的浏览器设置与网站数据。你可以用标签分类、批量启动或整理不再使用的副本。

◉

独立保存

Cookie、网站登录和浏览记录保存在各自副本中。

⌘

批量管理

搜索名称、标签或代理;多选后统一启动、停止或移入回收站。

⧉

复制设置

克隆副本复用原有指纹开关,并为新副本生成独立标识。

选择语言与时区

新建或编辑副本时,进入「高级设置」。浏览器语言与自定义时区支持搜索下拉:可以选择常用项,也可以输入自定义值后确认。浏览器语言使用 en-US,en 这样的格式,多个语言以英文逗号分隔,首项为首选语言;时区使用 Asia/Singapore 这样的 IANA 名称。

整理与恢复

  • 用标签和备注标记用途,再用搜索或标签筛选器快速定位。
  • 移入「最近删除」的副本可以恢复;永久删除会清除该副本的数据。
  • 复制副本会复制可复用的配置,不会把原副本的登录会话直接带到新副本。
03 PROXY & FINGERPRINT

代理与浏览器环境

代理和环境选项按副本设置。保存配置后重新启动副本,使浏览器使用更新后的设置。

代理

选择系统代理、直连,或设置 HTTP、HTTPS、SOCKS5 地址。启动前可运行代理检测查看出口连通性。

区域

语言和时区可以跟随代理 IP 自动匹配,也可以按需指定;定位、通知、摄像头与麦克风等权限可逐项管理。

指纹

新建副本会得到独立指纹;同一副本重启后保持稳定。需要更换时,在副本设置中使用「重新生成指纹」。

隐私参数

可设置 WebRTC、Canvas、WebGL 与 AudioContext 等浏览器特征。默认噪音模式会为副本生成可重复的环境表现。

✳
设置的一致性很重要
代理出口、语言和时区共同描述浏览环境。修改代理后检查区域设置,再在目标网站查看实际表现。
04 SYNC & SHARE

在设备间同步,或分享给朋友

云端同步让你在已授权设备间接续所选副本;好友分享会发送一份独立快照。

选择副本后在本机加密,再同步到已授权设备

设置云端同步

  1. 登录账号,打开「偏好设置 → 云端同步」,开始初始化并安全保存恢复密钥。
  2. 关联要同步的副本,选择是否同步网站登录状态,再连接其他授权设备。
  3. 选择自动同步或手动执行。发现冲突时先查看本机与云端版本,再选择保留方向。
妥善保管恢复密钥

恢复密钥用于在新设备上解密同步数据。失去密钥和所有已授权设备后,云端数据无法恢复。

好友分享

输入接收人的账号信息并设置有效期。接收人接受邀请后使用一份独立快照;后续调整或撤销分享,可在自己的分享管理中完成。分享登录状态前,确认其中的账号仍适合提供给对方使用。

登录状态受浏览器和网站保护机制影响。迁移到新设备后,网站可能要求重新登录。

05 TERMINAL

设置终端目录与环境

在终端页面选择项目文件夹,再打开 Claude Code、Codex CLI、Gemini CLI 或普通终端。

NodeCloak / Terminal
工作目录  C:\Users\you\Projects\my-app

> claude

目录选择器支持直接填写完整路径或浏览选择文件夹。命令行工具需要单独安装并完成它自己的账号登录;浏览器副本的代理设置不会自动改变终端网络出口。

按工具保存环境

在 3.0.1 及后续版本中,Claude Code、Codex CLI、Gemini CLI 和普通终端可以分别选择「继承系统」或「自定义」。自定义时设置时区、LANG、LC_ALL,以及代理、API 地址、PATH 等环境变量;空白的时区与语言字段继承已有值。

  1. 选择工具与工作目录,再选择环境模式。
  2. 在下拉菜单中搜索时区、LANG、LC_ALL,选择常用项或确认自定义输入;选择「继承已有值」可沿用对应字段。按需添加环境变量并检查启动预览,自定义变量值默认隐藏。
  3. 选择「保存环境」以便下次使用;点击打开终端时使用当前表单配置。

已保存的环境配置在本机加密保存。每个工具最多添加 32 个自定义变量,变量名和值合计最多 24 KiB。终端继承未覆盖的变量,因此可以沿用已有 API 密钥与代理。

06 TROUBLESHOOTING

常见问题排查

启动浏览器后页面一直加载

检查代理地址、端口和认证信息,运行代理检测;再确认本机网络可访问目标网站。可先用直连测试,区分浏览器与代理连接问题。

提示页面导航或加载超时

网页可能加载缓慢、跳转到其他域名,或等待了较长的第三方资源。确认目标地址能够在普通浏览器打开,再重试;如果浏览器副本窗口仍在,可以直接检查页面实际状态。

新副本与原副本表现不同

新副本使用独立的 Cookie、网站存储和指纹,网站会把它当作一个新环境。按需重新登录,并检查副本的代理、语言、时区和权限。

浏览器控制连接中断

3.0.1 会先尝试恢复控制连接,正常关闭浏览器时更新副本状态。Firefox 恢复失败时按提示重启副本。查看实际页面后再重试未完成的操作。需要排查时,可在副本数据目录查看 nodecloak-control.jsonl 错误记录。

设置修改后没有生效

先停止正在运行的副本,再启动一次。部分浏览器参数只会在浏览器启动时读取。

同步后网站仍要求登录

部分网站登录数据受设备密钥或浏览器策略保护。确认已启用登录状态同步,然后按网站提示重新验证。

诊断后如何撤销修改

在「修复记录」查看可恢复的系统设置快照,并按记录还原。应用更新与个人配置可在偏好设置中查看。

NEED A HAND?

把问题描述清楚,排查会更快。

提供应用版本、浏览器类型和完整错误文字;截图请先遮住账号、密钥与个人信息。

联系支持 ↗