新手朋友不用怕,跟着下面的步骤一步步来,就能在 1Panel 上把服务跑起来。

整个过程主要分三步:准备好两个配置文件 → 获取关键的 Cookie → 在 1Panel 里点几下鼠标

📝 第一步:准备两个核心配置文件

你需要准备两个文件,并放在电脑的同一个文件夹里(比如新建一个叫 gemi2api 的文件夹)。

  1. docker-compose.yml:这是告诉 Docker 如何运行这个服务的“说明书”。
    • 你可以从项目的 GitHub 页面直接获取。访问 https://github.com/zhiyu1998/Gemi2Api-Server,找到 docker-compose.yml 文件,把里面的全部内容复制下来,粘贴到你新建的 docker-compose.yml 文件中保存。
    • 这个文件通常不需要修改,直接用就行。
  2. .env:这是存放你个人登录凭证的“钥匙”文件。
    • 同样在项目 GitHub 页面找到 .env.example 文件,复制其内容,在同一个 gemi2api 文件夹下新建一个名为 .env 的文件,把内容粘贴进去。
    • 重要! 打开你新建的 .env 文件,你会在里面看到类似 COOKIE= 的字样,它的值需要你从浏览器里复制过来,这就是下一步我们要做的事。

🔑 第二步:获取 Gemini 的 Cookie(最关键的一步)

Cookie 就像是你的临时登录凭证,Gemi2Api-Server 需要用这个凭证来模拟你登录 Gemini 网页版。

  1. 用电脑浏览器(推荐 Chrome 或 Edge)打开并登录 gemini.google.com
  2. 按键盘上的 F12 键,打开“开发者工具”。
  3. 在开发者工具里,找到 “Application”(应用程序)或 “Storage”(存储)标签页。
  4. 在左侧菜单中,展开 “Cookies”,然后点击 https://gemini.google.com
  5. 在右侧的列表中,找到名为 __Secure-1PSID 的那一行。
  6. 双击 “Value”(值)那一列的内容,选中并复制下来。
  7. 回到你的 .env 文件,将复制的值粘贴到 COOKIE= 的后面。

请注意:这个 Cookie 可能会不定期过期,如果之后服务不能用了,很可能就是需要你重复以上步骤,获取一个新的 Cookie 并更新到 .env 文件中,然后重启服务。

🚀 第三步:在 1Panel 中部署

现在,把准备好的文件上传到服务器,再通过 1Panel 的可视化界面部署。

  1. 上传文件:将你电脑上 gemi2api 文件夹里的 docker-compose.yml 和 .env 这两个文件,上传到你的服务器上,并放在同一个目录里,比如都放在 /opt/gemi2api/ 下。
  2. 登录 1Panel:在浏览器里打开你的 1Panel 面板并登录。
  3. 进入编排页面:在左侧菜单栏找到 “容器”,然后点击 “编排”(Compose)。
  4. 创建编排:点击 “创建编排” 按钮。
  5. 选择路径方式:在新建页面中,“来源” 选择 “路径选择”
  6. 填写信息
    • 名称:给这个服务起个名字,比如 gemi2api
    • 路径:选择或输入你上传 docker-compose.yml 文件的那个文件夹路径(例如 /opt/gemi2api/)。
  7. 确认并部署:检查信息无误后,点击页面下方的 “确认” 或 “部署” 按钮。1Panel 会自动读取配置文件、拉取镜像并启动服务。

✅ 第四步:验证部署

部署成功后,在 1Panel 的 “容器” -> “容器” 列表中,你应该能看到一个名为 gemi2api 的容器正在运行。此时,服务已经启动,默认监听在 8000 端口。

💎 总结与提醒

  • 访问地址:服务成功运行后,你可以通过 http://你的服务器IP:8000 来访问它。
  • 记住关键点:整个过程最关键的一步就是正确获取并填写 __Secure-1PSID 这个 Cookie 值
  • Cookie 会过期:如果之后服务突然用不了了,大概率是 Cookie 过期了。你需要重复第二步的操作,获取新 Cookie 并更新 .env 文件,然后在 1Panel 的“编排”页面重启这个项目就可以了。

如果在操作中遇到任何问题,随时可以再来问我

Leave a Reply

您的邮箱地址不会被公开。 必填项已用 * 标注

Related Post