新手朋友不用怕,跟着下面的步骤一步步来,就能在 1Panel 上把服务跑起来。
整个过程主要分三步:准备好两个配置文件 → 获取关键的 Cookie → 在 1Panel 里点几下鼠标。
📝 第一步:准备两个核心配置文件
你需要准备两个文件,并放在电脑的同一个文件夹里(比如新建一个叫 gemi2api 的文件夹)。
docker-compose.yml:这是告诉 Docker 如何运行这个服务的“说明书”。.env:这是存放你个人登录凭证的“钥匙”文件。
🔑 第二步:获取 Gemini 的 Cookie(最关键的一步)
Cookie 就像是你的临时登录凭证,Gemi2Api-Server 需要用这个凭证来模拟你登录 Gemini 网页版。
- 用电脑浏览器(推荐 Chrome 或 Edge)打开并登录
gemini.google.com。 - 按键盘上的
F12键,打开“开发者工具”。 - 在开发者工具里,找到 “Application”(应用程序)或 “Storage”(存储)标签页。
- 在左侧菜单中,展开 “Cookies”,然后点击
https://gemini.google.com。 - 在右侧的列表中,找到名为
__Secure-1PSID的那一行。 - 双击 “Value”(值)那一列的内容,选中并复制下来。
- 回到你的
.env文件,将复制的值粘贴到COOKIE=的后面。
请注意:这个 Cookie 可能会不定期过期,如果之后服务不能用了,很可能就是需要你重复以上步骤,获取一个新的 Cookie 并更新到
.env文件中,然后重启服务。
🚀 第三步:在 1Panel 中部署
现在,把准备好的文件上传到服务器,再通过 1Panel 的可视化界面部署。
- 上传文件:将你电脑上
gemi2api文件夹里的docker-compose.yml和.env这两个文件,上传到你的服务器上,并放在同一个目录里,比如都放在/opt/gemi2api/下。 - 登录 1Panel:在浏览器里打开你的 1Panel 面板并登录。
- 进入编排页面:在左侧菜单栏找到 “容器”,然后点击 “编排”(Compose)。
- 创建编排:点击 “创建编排” 按钮。
- 选择路径方式:在新建页面中,“来源” 选择 “路径选择”。
- 填写信息:
- 名称:给这个服务起个名字,比如
gemi2api。 - 路径:选择或输入你上传
docker-compose.yml文件的那个文件夹路径(例如/opt/gemi2api/)。
- 名称:给这个服务起个名字,比如
- 确认并部署:检查信息无误后,点击页面下方的 “确认” 或 “部署” 按钮。1Panel 会自动读取配置文件、拉取镜像并启动服务。
✅ 第四步:验证部署
部署成功后,在 1Panel 的 “容器” -> “容器” 列表中,你应该能看到一个名为 gemi2api 的容器正在运行。此时,服务已经启动,默认监听在 8000 端口。
💎 总结与提醒
- 访问地址:服务成功运行后,你可以通过
http://你的服务器IP:8000来访问它。 - 记住关键点:整个过程最关键的一步就是正确获取并填写
__Secure-1PSID这个 Cookie 值。 - Cookie 会过期:如果之后服务突然用不了了,大概率是 Cookie 过期了。你需要重复第二步的操作,获取新 Cookie 并更新
.env文件,然后在 1Panel 的“编排”页面重启这个项目就可以了。
如果在操作中遇到任何问题,随时可以再来问我