NestBrowser NestBrowser

Cookie 與帳號匯入指南

匯入現有 Cookie 和帳號資料是 NestBrowser 最實用的功能之一。無論是遷移舊裝置上的帳號、從其他瀏覽器遷移，還是恢復已培養的帳號環境，Cookie 匯入功能都能讓您略過漫長的手動登入過程，直接進入工作狀態。

對於多帳號運營者來說，Cookie 代表著帳號狀態：登入憑證、工作階段權杖、平台個人化設定。

如果您正在：

  • 遷移已有帳號：從舊裝置或其他瀏覽器遷移至 NestBrowser
  • 團隊移交帳號：將帳號控制權從一位運營人員轉交給另一位，同時保留登入狀態
  • 恢復備份：從儲存的備份還原帳號狀態
  • 降低偵測風險：已培養的帳號（有瀏覽歷史和 Cookie）比全新帳號偵測風險更低

支援的匯入格式

NestBrowser 支援以下 Cookie 格式匯入：

  • JSON 格式（Chrome/Chromium 擴充功能匯出格式）
  • Netscape 格式（文字檔，被 curl 和各工具廣泛支援）
  • Base64 編碼格式（用於批次操作的 API 格式）

使用 Chrome 擴充功能匯出

安裝「Cookie Editor」類擴充功能（如 EditThisCookie），在登入目標帳號後：

  1. 導覽至目標網站（如 amazon.com）
  2. 點擊擴充功能圖示
  3. 點擊「匯出」→ 選擇 JSON 格式
  4. 儲存檔案（如 amazon-account-a.json）

匯出的 JSON Cookie 格式範例：

[
  {
    "domain": ".amazon.com",
    "expirationDate": 1734567890,
    "httpOnly": true,
    "name": "session-id",
    "path": "/",
    "sameSite": "unspecified",
    "secure": true,
    "value": "xxx-xxxxxxx-xxxxxxx"
  }
]

第二步：在 NestBrowser 中匯入

  1. 在配置檔案清單中找到目標配置檔案
  2. 點擊配置檔案右側的更多動作圖示
  3. 選擇匯入 Cookie
  4. 上傳匯出的 JSON 檔案
  5. 確認匯入

第三步：驗證登入狀態

啟動配置檔案，導覽至對應網站，驗證是否已處於登入狀態。

方式二：透過 API 批次匯入

對於需要批次處理的場景，可以透過 NestBrowser 本地 API 以程式化方式匯入 Cookie。

const axios = require('axios');

async function importCookies(profileId, cookies) {
  const response = await axios.post(
    'http://localhost:19222/api/v1/browser/cookies/import',
    {
      id: profileId,
      cookies: cookies,  // 陣列格式的 Cookie 物件
    }
  );
  return response.data;
}

// 使用範例
const cookieData = require('./amazon-account-a.json');
await importCookies('profile-uuid', cookieData);

批次處理多個帳號

const fs = require('fs');
const path = require('path');

const cookieFiles = fs.readdirSync('./cookies').filter(f => f.endsWith('.json'));

for (const file of cookieFiles) {
  const profileId = path.basename(file, '.json');
  const cookies = JSON.parse(fs.readFileSync(`./cookies/${file}`, 'utf8'));
  await importCookies(profileId, cookies);
  console.log(`已匯入 ${profileId} 的 Cookie`);
}

匯入後的注意事項

  • Cookie 有效期：部分平台的 Cookie 在 7–30 天後過期，需要重新登入
  • 裝置指紋一致性：匯入 Cookie 後，確保環境的指紋設定與原始登入裝置相符
  • 雙因素驗證：若帳號啟用了 2FA，即使 Cookie 有效，部分操作仍可能需要驗證