清绝的博客

评论区可以发表情啦！

Mon, 13 Apr 2026 15:27:26 GMT

一时兴起，博客又搬家了，嘿嘿！搬家也是越来越熟练了！

现在评论区可以发表情啦！快来试试吧！

很可爱吧？

来都来了

分享一首好听的歌~

甲骨文云永久免费机器获取指南

Sun, 12 Apr 2026 06:14:00 GMT

甲骨文云（Oracle Cloud）是一家企业级老牌云厂商，从 2019 年开始提供非常大额的免费云服务。审核严格，可能随时被回收，且审核和回收的机制没人摸得透，非常玄学。不过只要不放重要资料、勤备份就可以了。最大 4 核 / 24G / 200G 的永久免费机子，值得个人玩家每日一摸。

心态预期

这是教你去哪碰运气的教程，不是教你如何稳过的教程，世界上没有那种教程。注册不了、注册了开不到机子、开完机子被回收，都是常态。

准备工作

1. 外币卡

准备一张外币卡，借记卡或信用卡均可，VISA、万事达、运通都可以（银联不行），只要能刷出新加坡元即可。

阶段	金额
注册账号验证	1.38 坡币
开机阶段升级（可选）	138.19 坡币

Note

信用卡需要有额度，借记卡需要提前存钱。两种扣款均只是验证用途，不会实际收费，但极低概率有人反映退款失败。对零门槛外币卡有需求可以留言，考虑出推荐。

2. 网络环境

关闭 Wi-Fi，关闭代理，使用手机流量。 不要做任何特殊改变，保持原生网络。

3. 确认 IP 归属地

打开 iplark.com，下拉查看地理位置：

如果位置与你家/身份证地址差不多 → 可填真实地址
如果位置不一样 → 按 IP 所在位置在地图上随便找个地方

4. 转换英文地址

随便找个 AI（豆包就行），使用以下提示词将地址转为英文：

请将以下地址转换为适合填写英文表单的格式，用于注册Oracle Cloud账号。

请按照以下字段输出，格式清晰，方便复制：

Address Line 1（地址行1，必填）：
Address Line 2（地址行2，选填）：
Address Line 3（地址行3，选填）：
City（城市）：
State / Province（省/自治区/直辖市）：
Postal Code（邮政编码）：

要求：
- 使用标准英文地址拼写（参考中国邮政或Google Maps的英文译名）
- 地址行1填写楼栋门牌号+街道，地址行2可填写小区/园区名称，地址行3可留空
- 省份使用拼音全拼（如 Guangdong、Beijing）
- 城市使用拼音全拼（如 Shenzhen、Chengdu）
- 邮政编码保持6位数字不变

我的地址是：
[在此粘贴你的中文地址]

注册账号

开始前建议洗个手、擦擦键盘，今日抽奖开始。对了，右上角能切中文。

用浏览器打开注册页面（我用的 Vivaldi 浏览器，没开无痕）：https://signup.cloud.oracle.com
填写账户基本信息（以 ” 李小明 ” 为例）：
- 国家/地区：中国
- 名字：Xiaoming
- 姓氏：Li
- 电子邮件：任意邮箱（我用的原始数字 QQ 邮箱）
收取验证邮件，找到黑色按钮 Verify email。

注意
不推荐直接在 QQ 邮箱 App 内点击跳转，容易卡住。建议右键复制链接，发到手机后用浏览器打开。如果提示 ” 操作频繁 “，关掉邮箱等几分钟再刷新就好了。
补充账户信息：
- 密码：≥ 8 位，含大写字母 + 小写字母 + 数字 + 特殊字符
- 备用姓名：Xiaoming Li
- Customer type：individual（个人）
- Cloud 账户名称：账号，自己取
- 主区域：服务器所在地区，慎重选择，注册后无法修改。推荐：圣何塞、大阪、春川、新加坡西、凤凰城、法兰克福。各区测速地址见文末。
勾选 选中此框……，继续。
填写地址信息（按 AI 给出的英文格式填写），填写手机号。
点击 添加付款验证方式 → Credit Card，填写卡号、有效期、CVN（卡背面签名条末尾 3 位数字）。
勾选协议，点击 开始我的免费试用。

开奖结果

成功： 页面正常跳转加载，耐心等待完成即可。

注册成功示意

失败： 出现 abc，这才是常态，明天再来。大部分情况不是你的问题，卡是唯一必须真实的要素，其他信息乱填也能过，纯看甲骨文心情。

注册失败示意

首次登录

打开官网：https://cloud.oracle.com
输入 Cloud 账户名称（自己取的账号）
登录步骤1
输入邮箱和密码。
登录步骤2
首次登录会要求设置两步验证（2FA）。点击设置，勾选 脱机模式。
2FA设置
选择 手动密钥，复制并保存好这串字符，这个是生成动态验证码用的。
手动密钥
用任意 2FA 工具生成动态码，推荐 Google 身份验证器、Vaultwarden，或随便找个网页，我随便搜的 2fa.cn。输入密钥得到 6 位动态码，输回去就绑好了。每次登录都需要这个动态码，这串密钥一定存好。

开机前：资源分配

免费额度规则

服务器分为两种架构，AMD 小鸡和 ARM 大鸡。

资源	限额
总硬盘	200 GB（所有机子合计）
单机最小硬盘	50 GB
出站流量	10 TB / 月
AMD (x86)	固定 1C1G，最多 2 台
ARM	总计 4C24G，可自由分配

开机后：CPU / 内存可随时在范围内调整；硬盘只能扩不能缩，且扩硬盘比调整 CPU 内存麻烦一点，建议 开机前想清楚。

分配方案参考

新手推荐

推荐开两台 ARM。万一机子变砖，可以用同架构的另一台互救，避免因热门地区难开机而陷入两难。

方案	配置	适合人群
⭐ 方案一	ARM 2C/12G/50G × 2 + AMD 1C/1G/50G × 2	4 台可互救可折腾
⭐ 方案二	ARM 2C/12G/100G × 2	不想开 AMD，硬盘都给 ARM
⭐ 方案三	ARM 3C/18G/150G × 1 + ARM 1C/6G/50G × 1	一主一备
方案四	ARM 4C/24G/200G × 1	单机满配
方案五	ARM 4C/24G/100G × 1 + AMD 1C/1G/50G × 2	大主机 + 两小机
方案六	ARM 1C/6G/50G × 4	四台均分

没有标准答案，自己喜欢就行。

开机

登录后顶部会有升级横幅，可以先试着开机，开不了再升级（升级说明见末节）。

升级横幅

入口： 左上角菜单 → 实例 → 创建实例

进入实例

创建实例

Step 1：基本信息

更改映像（操作系统）

更改映像

选择 Ubuntu → Canonical Ubuntu 24.04（不过我后续通常会重装为 Debian）

选择Ubuntu

更改配置（架构）

更改配置

Ampere = ARM 大鸡
专业和上一代 = AMD 小鸡

这里是开 ARM 和 AMD 操作唯一的不同。认准免费标签，选第一项，勾选前面的点。CPU 和内存可以先保持默认配置，开机后再扩。

配置选择

选完后应显示如下（Ubuntu + ARM）：

配置预览

下一步。

Step 2：安全

无需更改，下一步。

Step 3：网络

选择 创建新虚拟云网络。
创建VCN
SSH 密钥：
- 有自己的密钥 → 选 上载公钥，上传公钥文件
- 没有或者不知道是啥 → 点 下载私有密钥，下载 .key 文件并保存好，这是连接服务器的凭证
  SSH密钥

下一步。

Step 4：存储

勾选 指定定制的引导卷大小和性能设置 ，这里是设置硬盘的。
引导卷大小：按分配方案填写，最低 50G，设大了不能缩。全账号合计不超过 200G。
引导卷性能：拉满，填 120。

存储设置

下一步。

Step 5：复查

确认以下信息无误后点击创建：

项目	预期值
操作系统	Canonical Ubuntu 24.04
配置	VM.Standard.A1.Flex（这是 ARM 大鸡）
配置构建	1 个核心 OCPU，6 GB 内存（开机后可扩）
指定定制的引导卷大小和性能设置	硬盘大小，自己设的
引导卷性能	120

开机成功后，实例列表会出现一条新记录：

PixPin_2026-04-12_12-15-52.jpg

Tip

如果没开到，可多次尝试，或先升级账号再试，基本可以成功（见末节）。

初始化设置 · 面板部分

扩容 CPU / 内存

点击实例名称进入详情页。
实例详情
右上角 操作 → 更多操作 → 编辑。
编辑入口
展开配置，填写目标 CPU 和内存，点 保存更改，确认重新引导即可。
扩容设置

Warning

所有 ARM 实例合计不得超过 4C / 24G。

获取公网 IPv4 地址

实例详情页 → 网络 → 看第一行 公共 IPv4 地址。如果已有，直接复制下来记好，这一步整个可以跳过。
如果没有，下拉找到 附加的 VNIC，点击名称进入。
附加VNIC
IP 管理 → 编辑。
IP管理
预留的公共 IP → 创建新的预留 IP 地址 → 随便填写名称 → 更新。
创建IP
现在应该可以看到公网 IPv4 地址了，复制保存。
查看IP

放行端口（面板防火墙）

甲骨文面板防火墙入口比较深，建议直接全放行，在机内自行安装 UFW 管理。

实例详情页 → 网络 → 点击 附加的 VNIC 的 子网/VLAN 链路 进入。
子网链路
安全 → 点击安全列表名称进入。
安全列表
点安全规则，这里就是防火墙了。分为入站规则（别人访问机子）和出站规则（机子访问网络）。通常出站应全部放行，让机子可以正常访问网络，入站则是按需最小化开启。不过我们这里不用它，全部放行。
删除全部现有入站规则，然后 添加入站规则：
- 源：0.0.0.0/0
- IP 协议：所有协议
- 确认保存
  添加规则
最终入站规则如图，这样就是全部放行了，出站保持默认就是全放行：
规则结果

此时应该已经可以 ping 通你的 IPv4 地址了。

初始化设置 · 机内部分

SSH 连接信息

项目	值
公网 IP	上一步获取的 IPv4 地址
端口	`22`（默认）
用户名	`ubuntu`（Ubuntu 系统默认；Debian 系统为 `root`）
密钥	下载的 `.key` 文件

SSH 工具推荐

推荐新手使用 Netcatty：

GitHub（需海外网络）：Netcatty Releases
直链备用（版本固定，可能不是最新）：Netcatty-1.0.88-win-x64.exe

Github 下载，Windows 普通电脑选 x64 版本。

Netcatty界面

连接服务器

点击 新建主机。
新建主机
填入上方 4 项连接信息。
填写信息
（可选）甲骨文网络质量一般，可以配置代理让 SSH 走代理连接。下拉找到 通过 HTTP/SOCK5 代理：
- 服务器：127.0.0.1
- 端口：本机代理端口（在左下角开始菜单旁边搜索 ” 代理服务器设置 ” 或代理软件中查看）
  代理设置1
  
  代理设置2
保存后，首页出现服务器卡片，点击连接。
服务器卡片
连接成功界面：
PixPin_2026-04-12_14-44-50.jpg

机内防火墙初始化

甲骨文系统镜像内置了一堆 iptables 规则，需要清理干净。

依次执行以下命令（等光标回到 ~$ 再输下一条）：

# 1. 查看当前规则（应有一大堆内容）
iptables -L -n

# 2. 重置所有规则
iptables -P INPUT ACCEPT
iptables -P FORWARD ACCEPT
iptables -P OUTPUT ACCEPT
iptables -F

# 3. 防止规则开机复活
apt-get purge iptables-persistent -y

# 4. 再次确认，现在应只剩几行基础信息
iptables -L -n

完成

到这里初始化完成，甲骨文和普通服务器就没有区别啦。可以参考《Linux 云服务器一键部署酒馆》开头的“服务器初始化与安全加固”部分，用咕咕助手一键装防火墙、防爆破等，老手也可以考虑重装为 Debian。

关于重装系统

重装系统可以去掉官方监控，据传能降低被回收的概率（真实性存疑，但实测机子一直活着）。操作失误有变砖风险，这也是推荐开两台 ARM 互救的原因。有需要可以留言告诉我，考虑出教程。

闲置回收与升级

闲置回收机制

官方规定：在连续 7 天内，满足以下条件就存在被清理的风险：

CPU 利用率有 95% 的时间低于 20%
网络利用率低于 20%
内存利用率低于 20%

常见的防回收方案：

防回收脚本（强行拉高资源占用）
重装系统，直接干掉官方监控

升级为按需付费账号

开不到机时，考虑升级。

Important

升级后，只要严格使用永久免费额度内的资源（200GB 存储、ARM 总 4C24G、10TB/月流量等），账单依然为 ¥0，不会花一分钱。

升级的好处： 升级后更容易开到 ARM 大鸡。 注意： 并没有提到升级会不容易被回收。

升级步骤

刷新页面，顶部会出现升级横幅，点击蓝字升级。
升级横幅
输入手机号，格式为 +8612312341234（+86 与号码之间无空格）。
重新绑卡。注册时验证的卡不会保存，需要重新填写。此次验证金额为 138.19 坡币，同样是假扣款，但听说过有极低概率出现退款失败，自行权衡。
点击 升级账户。

升级结果

成功： 页面显示 ” 正在升级，升级完成后，您将收到电子邮件确认 “，约 4 小时后收到确认邮件，此后再去开机基本可以成功。

失败（abc）： 尝试切换回注册成功时所用的网络环境，升级这一步同样会验一次网络环境。

附：各区测速地址

部分地区已绝版或无法开机，建议自行做功课确认。

亚太地区

地区	测速地址
日本东京	objectstorage.ap-tokyo-1.oraclecloud.com
日本大阪	objectstorage.ap-osaka-1.oraclecloud.com
韩国首尔	objectstorage.ap-seoul-1.oraclecloud.com
韩国春川	objectstorage.ap-chuncheon-1.oraclecloud.com
新加坡	objectstorage.ap-singapore-1.oraclecloud.com
新加坡西	objectstorage.ap-singapore-2.oraclecloud.com
澳大利亚悉尼	objectstorage.ap-sydney-1.oraclecloud.com
澳大利亚墨尔本	objectstorage.ap-melbourne-1.oraclecloud.com
印度孟买	objectstorage.ap-mumbai-1.oraclecloud.com
印度海得拉巴	objectstorage.ap-hyderabad-1.oraclecloud.com

北美地区

地区	测速地址
美国阿什本	objectstorage.us-ashburn-1.oraclecloud.com
美国凤凰城	objectstorage.us-phoenix-1.oraclecloud.com
美国圣何塞	objectstorage.us-sanjose-1.oraclecloud.com
美国芝加哥	objectstorage.us-chicago-1.oraclecloud.com
加拿大蒙特利尔	objectstorage.ca-montreal-1.oraclecloud.com
加拿大多伦多	objectstorage.ca-toronto-1.oraclecloud.com
墨西哥克雷塔罗	objectstorage.mx-queretaro-1.oraclecloud.com
墨西哥蒙特雷	objectstorage.mx-monterrey-1.oraclecloud.com

南美地区

地区	测速地址
巴西圣保罗	objectstorage.sa-saopaulo-1.oraclecloud.com
巴西维涅多	objectstorage.sa-vinhedo-1.oraclecloud.com
智利圣地亚哥	objectstorage.sa-santiago-1.oraclecloud.com
智利瓦尔帕莱索	objectstorage.sa-valparaiso-1.oraclecloud.com
哥伦比亚波哥大	objectstorage.sa-bogota-1.oraclecloud.com

欧洲

地区	测速地址
英国伦敦	objectstorage.uk-london-1.oraclecloud.com
英国加的夫	objectstorage.uk-cardiff-1.oraclecloud.com
德国法兰克福	objectstorage.eu-frankfurt-1.oraclecloud.com
瑞士苏黎世	objectstorage.eu-zurich-1.oraclecloud.com
瑞典斯德哥尔摩	objectstorage.eu-stockholm-1.oraclecloud.com
荷兰阿姆斯特丹	objectstorage.eu-amsterdam-1.oraclecloud.com
法国巴黎	objectstorage.eu-paris-1.oraclecloud.com
法国马赛	objectstorage.eu-marseille-1.oraclecloud.com
西班牙马德里	objectstorage.eu-madrid-1.oraclecloud.com
意大利米兰	objectstorage.eu-milan-1.oraclecloud.com

中东和非洲

地区	测速地址
阿联酋迪拜	objectstorage.me-dubai-1.oraclecloud.com
阿联酋阿布扎比	objectstorage.me-abudhabi-1.oraclecloud.com
沙特阿拉伯吉达	objectstorage.me-jeddah-1.oraclecloud.com
沙特阿拉伯利雅得	objectstorage.me-riyadh-1.oraclecloud.com
以色列耶路撒冷	objectstorage.il-jerusalem-1.oraclecloud.com
南非约翰内斯堡	objectstorage.af-johannesburg-1.oraclecloud.com

咕咕助手 · 预设控制台编辑器使用教程

Fri, 10 Apr 2026 00:00:00 GMT

PixPin_2026-04-10_04-30-23

把预设条目变成可点击的控制台面板，无需手写脚本。

如果你做过酒馆预设，大概都遇到过这个问题：预设里有几十个条目，文风开关、篇幅开关、模式开关散落各处，分享给别人之后，用户根本不知道该开哪个、关哪个。

预设控制台编辑器就是为了解决这个问题。它能把你预设里那些零散的条目，整理成一个用户可以直接点击的控制台面板，用户点按钮就能切换文风、开关功能，完全不需要进预设条目列表自己找。

安装

使用前须知

当前适配 OpenAI 预设。
功能依赖 JS-Slash-Runner（酒馆助手）。

在酒馆扩展菜单的"安装扩展程序"窗口中填入本仓库地址，刷新后即可在"扩展程序"（魔法棒）菜单里找到 预设控制台编辑器。

大陆版：

https://gitee.com/canaan723/gugu-preset-console-editor

海外版：

https://github.com/qingjue723/gugu-preset-console-editor

image-20260410050135631

整体思路

用这个编辑器做控制台，本质上只有四步：

扫描预设 → 新建分组 → 新建按钮 → 绑定条目 → 写入脚本

左侧是你的"素材库"（预设里真实存在的条目），中间是你搭建控制台的地方（分组和按钮），底部是实时预览。做好之后写入预设，用户打开酒馆就能看到控制台。

第一步：扫描预设

先在酒馆里切换到你要制作控制台的 OpenAI 预设，然后打开编辑器，点击顶部的 扫描当前预设。

左侧条目区会显示出当前预设里所有条目，顺序与预设一致，可以按标题或 ID 搜索。

每次修改预设结构（新增条目、调整顺序、换版本）之后，都建议重新扫描一次，保持条目目录与预设同步。

第二步：填写基本信息

扫描之后，填写顶部的几个字段：

字段	说明
项目名	编辑器内部标识，只有你自己看到
脚本名	写入酒馆助手后显示的脚本名
启动按钮名	用户在聊天输入框上方看到的入口按钮文字
面板标题	用户打开控制台后顶部的标题
发布页 URL	选填，填后面板右上角会出现跳转按钮

第三步：搭建分组和按钮

中间的分组区是核心。左边是分组编辑区，右边是按钮编辑区。

顶部有五种分组类型可以新建，根据你的需求选择：

单选组

同组内只能激活一个按钮。 点击某个按钮时，该按钮绑定的条目开启，其余按钮绑定的条目关闭。

适合文风 N 选一、篇幅 N 选一、人称 N 选一这类场景。

多选组

每个按钮独立开关，可以同时激活多个。

适合增强功能、可叠加的写作修饰、附加限制这类场景。

总开关组

固定为"开启"和"关闭"两个按钮，适合做复杂功能的大模式开关。

总开关组可以配置两类内容：

受控条目：直接由总开关控制开/关的预设条目。开启时这些条目全部开启，关闭时全部关闭。
开启时显示的分组：总开关开启时，指定分组显示；关闭时这些分组隐藏。适合做"开启后才出现的进阶选项"。

链接组

放外链按钮，如发布页、教程页、更新日志。

说明组

放纯文字说明，不控制任何条目，如使用说明、注意事项。

第四步：绑定条目

新建好按钮之后，就可以把预设条目绑定上去了。

绑定方法：

在左侧条目区勾选目标条目（可以单选或多选）。
在分组区选中目标按钮。
点击 绑定勾选条目。

绑定是追加而非覆盖——已有绑定保留，新条目加入，重复条目自动跳过。如果按钮还是默认名称，会自动以首个绑定条目命名。

解除绑定： 进入按钮编辑区，勾选要移除的条目，点击 取消选中绑定。可用 全选/全不选 快速全选。

总开关绑定受控条目： 与普通按钮相同——勾选条目 → 选中总开关组 → 点击 绑定勾选条目。

让总开关控制分组显示： 选中总开关组，在"开启时显示的分组"区域勾选目标分组即可。

编辑器绑定的是条目的真实 ID，而非名称。条目顺序变了不影响绑定；但如果条目被删除或 ID 变更，绑定会失效，需要重新检查。

第五步：预览并写入

底部预览区可以切换 宽屏预览 和 窄屏预览，确认控制台在不同设备上的效果。

确认无误后，点击顶部的 写入预设脚本，写入当前预设。

当前预设里没有同名脚本 → 新增
已有同名脚本 → 覆盖更新
存在多个同名脚本 → 报错，需先手动整理

写入后刷新页面，点击你设置的启动按钮，验证控制台是否正常工作。

分享给用户

在开启脚本的情况下导出预设，脚本会随预设一起导出，用户拿到预设就能直接用。也可以用 下载脚本 JSON 单独导出一份备用。

如果你填了发布页 URL，用户打开控制台后还能直接跳到你的发布页。

其他顶部按钮

按钮	作用
`新项目`	新建空白项目，保存在编辑器内，适合给不同预设各做一套控制台
`删除项目`	删除当前编辑器项目，不影响预设本体
`复制脚本 JSON`	复制生成结果到剪贴板，适合临时备份或测试

遇到报错时

常见原因：

未先扫描当前预设
按钮或总开关没有绑定任何条目
发布页 URL 格式无效
预设脚本库里存在多个同名脚本
当前环境没有可用的 JS-Slash-Runner 运行时

优先排查：当前是否选中了正确预设、按钮绑定是否完成、脚本名是否与已有脚本重名。

酒馆扩展：咕咕助手 - 角色卡生成器

Wed, 08 Apr 2026 01:00:00 GMT

项目仓库：

github.com

GitHub - qingjue723/gugu-character-card-generator: 酒馆扩展 - 咕咕助手角色卡生成器

酒馆扩展 - 咕咕助手角色卡生成器. Contribute to qingjue723/gugu-character-card-generator development by creating an account on GitHub.

https://github.com/qingjue723/gugu-character-card-generator

声明本项目为免费开源项目，仅供个人学习和非商业用途使用。
未经作者授权，严禁将本项目或其修改版本用于任何形式的商业盈利行为。

一、前言

咕咕助手 - 角色卡生成器 是给酒馆新手用的小扩展。

此扩展无法替代完整高级的创作流程，但可以帮你快速拥有一个自己的角色。适合刚入门、想先做出第一个角色的玩家。

二、安装

进入酒馆的扩展页面。
点击 安装扩展，填入下面任意一个地址安装。

大陆版：

https://gitee.com/canaan723/gugu-character-card-generator

海外版：

https://github.com/qingjue723/gugu-character-card-generator

安装后刷新页面，在扩展菜单里找到 角色卡生成器 并展开即可。

三、使用

先配好 API，建议用好一点的模型。
在 生成角色卡 页面写要求，点击生成。通常要一两分钟，耐心等待。
切到 生成世界书 页面，填写要求并生成。
需要的话，再去 生成用户设定 补一个简短的用户设定。

注意事项

生成世界书和用户设定时，需要在角色管理里切换到当前角色才能读取。新生成的角色卡一般会自动切过去，不用额外处理。
用户设定是故意做得很短的，主要是不想把玩家设定框死。

四、手动修正

生成结果不满意可以自己改。除了角色描述和开场白，角色详情页里还藏着几处常用设置。

高级定义

点击头像右边的第二个按钮，打开 高级定义 页面。常用的三项：

创作者的元数据：可以展开。里面都是备注信息，给玩家看的，AI 看不到。
角色设定摘要：性格和设定的简短总结，会发给 AI。
对话示例：说话风格示例，会发给 AI。

对话示例格式固定：多组用 <START> 分隔，组内用 {{user}}: 和 {{char}}: 交替。

<START>
{{user}}:我妈今天又打电话催婚了，她觉得我现在的这份工作太累，不如早点找个人嫁了。
{{char}}:你听完之后是什么感觉？
{{user}}:很烦。我觉得她根本不了解我想要什么，但她毕竟是我妈，我又不能真的跟她大吵一架。
{{char}}:她的确用了一种错误的方式在表达关心，但你没有必要为了迎合她的期待而妥协。
{{user}}:你觉得我应该怎么做？
{{char}}:这是你的人生，我不能替你做决定。但如果你想继续这份工作，我会教你怎么优化流程来减轻疲惫感。如果你觉得烦，今晚的手机可以关机，我在这里陪你。

<START>
{{user}}:刚才聚会的时候，那个新来的男同事一直找我聊天，其实我还挺不好意思打断他的。
{{char}}:我注意到了。他很健谈，也很懂得怎么活跃气氛。
{{user}}:是啊，他还说周末要带我们去体验一家新开的密室逃脱。你怎么看起来一点反应都没有？
{{char}}:正常的社交互动，你有交朋友的自由，我为什么要干涉？
{{user}}:真的一点都不吃醋？
{{char}}:……如果你非要问的话。我并不享受看到别人试图引起你注意的画面。下次他再靠得那么近，我可能无法保证还能像今天这么得体。

<START>
{{user}}:知珩，你胃痛到底瞒了我多久？我在垃圾桶里看到了你扔掉的药盒。
{{char}}:只是偶尔有点不舒服，已经快好了。别担心，没多大问题。
{{user}}:你总是这样！什么都不说，什么都自己扛，你觉得这样很完美吗？
{{char}}:我没有觉得这样完美，我只是习惯了不去给别人添麻烦。
{{user}}:可我是你的伴侣，不是"别人"！
{{char}}:……抱歉，是我没处理好。我只是不知道该怎么告诉你，我也会有搞砸一切、连自己身体都控制不了的时候。给我一点时间适应这种"被照顾"的感觉，好吗？

多开场

回到详情页，点击第一条消息右边的 其他开场 按钮，可以继续设置多开局。

多开场在新聊天的左下右下切换。

五、世界书

点击头像右边第三个 地球按钮，查看角色绑定的世界书。

地球按钮是绿色时，说明已经绑定世界书。绑定后的世界书会自动开启，不需要再去世界书页面手动启用。

蓝灯 = 该条目固定发送给 AI。
绿灯 = 满足关键字时才发送，展开后可以看到触发关键词。

恭喜你拥有自己的角色啦。

酒馆扩展：咕咕助手 - 聊天草稿守护

Fri, 03 Apr 2026 01:30:00 GMT

项目仓库：

github.com

GitHub - qingjue723/gugu-chat-draft-guard: 酒馆扩展 - 咕咕助手草稿守护

酒馆扩展 - 咕咕助手草稿守护. Contribute to qingjue723/gugu-chat-draft-guard development by creating an account on GitHub.

https://github.com/qingjue723/gugu-chat-draft-guard

声明本项目为免费开源项目，仅供个人学习和非商业用途使用。
未经作者授权，严禁将本项目或其修改版本用于任何形式的商业盈利行为。

一、前言

这个扩展解决的是一个很常见的问题：

聊天内容明明已经出现在气泡里了，但报错保存失败，刷新页面就会丢记录。

这个扩展可以自动重试保存，也可以导出为文件随时手动导入，还会存一些近期快照可以手动恢复，多重兜底专治各种丢记录。

二、安装

进入酒馆的扩展页面。
点击 安装扩展 按钮。
在弹窗第一行输入框里填入下面这个仓库地址，然后点击 只给我安装。

大陆版：
```
https://gitee.com/canaan723/gugu-chat-draft-guard
```
海外版：
```
https://github.com/qingjue723/gugu-chat-draft-guard
```
看到绿色弹窗代表安装成功。
刷新酒馆页面。

三、使用

安装完成后，在扩展设置里可以看到 咕咕助手 - 聊天草稿守护。

无须设置就会自动工作。

它主要有两个功能：

1. 浮窗重试

这是自动的，也是最常用的，通常用这个就行。

当聊天已经出现在气泡里，但保存失败时，会出现状态浮窗，会自动重试。自动重试失败后，也可以手动重试或导出聊天文件。

2. 面板草稿

手动管理快照，算是一个小备份。可以预览、恢复、导出。

再也不相信 GitHub 了

Thu, 02 Apr 2026 17:30:00 GMT

1 点多本来想推一篇博文。

结果推不上去。

一开始还以为只是网络问题，毕竟 GitHub 偶尔推不动也不是第一次了。结果一看，是号被封了。

申诉要先登录。

但我号被封了，没法登录。

搜集了一些网络上的经验，最后选择用小号登录 Support 发工单。

大部分代码还好，本地七七八八。真正麻烦的是各种依赖这个号的服务。

很多平台只要支持 GitHub OAuth，基本都是直接用 GitHub 登录。现在一锅端啦。

我已经全勤大半年了，提交记录一直是绿的，生活、工作、娱乐，全都靠这个号。

很难说影响有多大，麻烦死了。

再也不相信 GitHub 了。

崩溃。

咕咕助手一键安装中转管理插件，集中管理酒馆 API 配置

Wed, 01 Apr 2026 00:00:00 GMT

PixPin_2026-03-31_18-25-09.png

本文介绍如何用 咕咕助手脚本 一键安装 咕咕助手 - 中转管理 扩展。

此工具适合在酒馆里保存了多个中转站 API 配置、想要集中查看余额、已使用、模型和常用入口的玩家。

中转管理的前后端仓库都是我的免费开源项目，请在 github 帮我点一个免费的 star 支持一下，谢谢：

github.com

GitHub - qingjue723/gugu-transit-manager: 酒馆扩展 - 咕咕助手中转管理前端

酒馆扩展 - 咕咕助手中转管理前端. Contribute to qingjue723/gugu-transit-manager development by creating an account on GitHub.

https://github.com/qingjue723/gugu-transit-manager

github.com

GitHub - qingjue723/gugu-transit-manager-plugin: 酒馆扩展 - 咕咕助手中转管理后端

酒馆扩展 - 咕咕助手中转管理后端. Contribute to qingjue723/gugu-transit-manager-plugin development by creating an account on GitHub.

https://github.com/qingjue723/gugu-transit-manager-plugin

部署和安装使用的工具是我的免费开源项目 咕咕助手：

GitHub - qingjue723/st-tools

https://github.com/qingjue723/st-tools

声明本项目和脚本均为免费开源项目，仅供个人学习和非商业用途使用。
未经作者授权，严禁将脚本或插件用于任何形式的商业盈利行为（包括但不限于倒卖、付费部署服务等）。
任何违反本协议的行为都将受到法律追究。

一、前言

这个插件分成两部分：

前端扩展 负责显示面板，也就是你在酒馆里看到的首页、详情页、关于页这些界面。
后端插件 负责代发请求、读取你在酒馆里保存的密钥、绕过浏览器跨域限制、刷新余额和模型。

所以它和普通只装一个前端面板的扩展不一样，前后端必须一起装 才完整。

而咕咕助手脚本做的事情，就是把这两个部分一起装好，并尽量把麻烦事一起处理掉：

前端扩展放到正确目录
后端插件放到正确目录
自动开启酒馆后端插件开关
后续更新也可以直接在脚本里完成（也可以在酒馆里更新）

不需要自己去折腾 plugins、extensions、config.yaml 这些东西。

它能做什么

自动读取你已经保存在酒馆里的 API 配置
刷新余额、已使用、24 小时变化、模型等信息
切换到某个 API 配置
给常用站点加分组、置顶、备注
打开站点主页、福利站、模型状态页、发布页

前提条件

你已经用咕咕助手部署好了酒馆。
你的咕咕助手已经更新到带有 咕咕宝箱 或 中转管理插件 菜单的版本。

本文的一键安装和使用说明，仅适配使用咕咕助手安装的酒馆。
如果你的酒馆是其他方式安装的，我更建议先改用咕咕助手，这样安装、更新、卸载、排错都会省事很多。
相关文章：

当然，你也可以自己去 GitHub 看前后端仓库文档手动安装。

二、安装

1. Windows / 安卓本地酒馆

打开咕咕助手。
输入 12 回车，进入 咕咕宝箱。
输入 1 回车，进入 咕咕助手 - 中转管理。
输入 1 回车，执行 安装/更新。
等待脚本安装完成。

安装完成后，重启酒馆，再刷新浏览器页面。

2. 云服务器 docker 酒馆

进入终端，唤出咕咕助手（命令 gugu 或 bash <(curl -sL gugu.qjyg.de/vps) ）。
进入酒馆的 应用运维管理 菜单。
输入 11 回车，进入 中转管理插件。
输入 1 回车，执行安装或更新。

脚本支持海内外仓库自动选择。
如果网络环境特殊，也可以在菜单里手动切换海内外仓库后再安装或更新。

三、使用

1. 关于

安装完成并重启酒馆后，进入酒馆网页。

你应该能在扩展区域看到 咕咕助手 - 中转管理，点击展开面板。

第一次进去后，先看关于页，先确认安装成功没。

关于页主要用来看这些状态：

前后端是否正常
当前能不能正常检查状态或更新

如果这里显示前后端都正常，说明装好了。

2. 首页

确认关于页正常后，再回首页。

首页会把在 API 连接设置中保存的配置列出来，能看到一些余额信息和快捷跳转按钮。

NEWAPI 需要配置一下才能显示余额。

3. 设置

点首页中的某个 API 配置，就会进入详情页，先进设置页面。

刷新相关

NEWAPI 系站点需要填写 面板令牌 和 用户 ID，在站点的 个人设置 页面可以看到自己的 用户 ID 和 生成令牌 ，填好之后就可以刷新查询余额了。

PixPin_2026-04-01_04-19-05.jpg

余额提醒、定时刷新

余额提醒：输入目标数值，余额低于这个数值会有弹窗和面板提醒。
定时刷新：默认每次启动时刷新+手动刷新，开启这个再加一项定时刷新。

按钮相关

站点页面
福利站
模型状态页
发布页

这些随便填，只影响按钮跳转到哪里，填或不填都不影响使用。

image-20260401160617451

4. 刷新

点刷新后，插件会做这几件事：

识别站点类型
刷新余额或额度信息
拉取模型列表

不同中转站的差异很大并未全部适配，目前仅实测了 NEWAPI 和 SUB2API 可以正常使用。

5. 切换配置

概览页可以切配置。

6. 忽略错误通知

如果有些站点无法适配，一直无意义报错，可以点击概览中的忽略错误。

四、常见问题

1. 为什么首页没有任何站点

因为它读的是 你已经保存在酒馆里的 API 配置。

如果原本配置页里没有保存过，那这里就不会有。

2. 为什么能打开面板，但刷新失败

站点本身不支持。
这个站点除了密钥，还需要额外的令牌或用户 ID。
请求地址没填对。
站点接口本身不稳定。

3. 为什么站点显示的数据和网页上不一样

因为不同站点返回的字段口径不同。

有的返回的是余额，有的返回的是剩余额度，有的是折算值，有的是赠送额度，有的还会把货币单位和积分混着返回。

所以插件能做的是尽量按站点规则去识别，但 最终还是以站点自己接口返回的数据为准。

4. 为什么有些站点能拉模型，有些拉不出来

这也是站点实现差异。

有些站的 /models 接口很标准，有些站没实现完整，还有些站虽然能聊天但模型接口是坏的。

但可能并不影响使用。

5. 脚本装好了，还需要手动去开 config.yaml 中的后端插件开关吗

正常情况下不用。

脚本安装时会自动帮你处理后端插件开关。

但如果你后面手动改过酒馆配置，把后端插件关掉了，那中转管理当然也会跟着失效，这时再去脚本菜单里打开后端插件开关即可。

五、后续管理

以后要更新，直接在面板的关于页面更新。

也可以回到脚本菜单里，进入原来的 中转管理 菜单，执行一次 安装/更新 就可以了。

如果要卸载，也是在同一个菜单里直接卸载。

酒馆无损迁移教程

Thu, 26 Mar 2026 07:04:00 GMT

很多用各种不同方式安装酒馆的宝宝想改用咕咕助手，或者手机、电脑、服务器数据想要互迁，其实非常简单，完全可以无损迁移。

在这里插播一个安利，咕咕助手是一个新人特别友好的酒馆安装和管理工具，一键安装、任意更新/回退酒馆版本、本地备份、云端备份等等功能非常方便，新人入坑有超完整教程还包 API，如果有新人朋友可以推荐一下哦。

原理

酒馆的程序本体和用户数据是完全分离的，只要把旧酒馆文件夹里面的用户数据替换到新酒馆文件夹里，就能让它们完完全全一模一样了。

认识重要文件和文件夹

通常搬家只要带走两个文件夹（图中有感叹号的），default-user 和 third-party。

default-user：个人数据文件夹，这是最最重要的。单用户模式下才叫这个，如果是多用户模式，就是一个和你账号同名的文件夹。

third-party：全局扩展，不是每个人都装过，如果你装扩展的时候选的是装给自己而不是装给全局，那你的扩展会装在 default-user 里的 extensions 里面，而非 third-party。因此，如果你所有的扩展都装给个人，你搬家就只需要带走 default-user 一个文件夹了。

 SillyTavern [酒馆根目录]
├──  data [用户数据目录]
│   ├──  _storage [用户账户信息（多用户账号、密码、是否是管理员身份）]
│   └──  !default-user [用户个人数据（单用户模式下，多用户去找账号同名目录）]
│       ├──  backgrounds [背景图]
│       ├──  backups [快照备份]
│       ├──  characters [角色卡]
│       ├──  chats [聊天记录]
│       ├──  extensions [个人前端扩展]
│       ├──  OpenAI Settings [预设]
│       ├──  QuickReplies [快速回复]
│       ├──  themes [主题]
│       ├──  user [用户设定]
│       ├──  User Avatars [用户头像]
│       ├──  vectors [向量数据]
│       ├──  worlds [世界书]
│       ├──  secrets.json [API密钥仓库]
│       ├──  settings.json [用户配置文件（界面配置、开关、当前选择项）]
├──  plugins [后端扩展]
├──  public 
│   ├──  scripts 
│   │   ├──  extensions 
│   │   │   ├──  !third-party [全局前端扩展]
└──  config.yaml [酒馆配置文件（网络与安全、登录体系、备份与性能）]

如何搬

以安卓单用户搬 PC 单用户为例，任意平台都是一样的。

确保两边的新旧酒馆都可以正常打开并进入，单用户还是多用户无所谓，两边不需要一样。
两边都停止游玩，可以不用关后台，但别写入新的了。
用任意方式将旧酒馆中的 default-user 和 third-party 两个文件夹打成压缩包（打一起还是分开无所谓，我们只是想把它运过去，结果达到即可），用任意方式传输到新酒馆目录下。
将新酒馆对应的 default-user 和 third-party 两个文件夹改个名字（改了名字就不生效了，对酒馆来说相当于删了，对你来说是备份，有后悔的余地）。
将压缩包解压，归位。原来在哪就在哪。注意嵌套问题，里里外外看一下，比如打开 data，里面有 default-user，打开 default-user，里面应该是如上一堆文件夹而不是又一个 default-user 文件夹，一定要对得上。
重启酒馆（不重启能打开但可能遇到头像刷不出来等等问题）。
确认没问题之后清理战场，解压前的压缩包、改了名字的备份文件夹等等都可以删了。

如果是单用户搬多用户、多用户搬多用户，也就是，用户名对不上的情况，比如一边是 default-user 一边是 abc，或者一边是 abc 一边是 def。道理是一样的，只不过我们搬的不是整个文件夹，是文件夹里面的内容，皮不用管，瓤换过去即可。

解决 Gemini 地区受限：使用咕咕助手一键部署 WARP 解锁送中 IP

Tue, 13 Jan 2026 13:45:00 GMT

一、前言

很多人购买了美国、日本服务器，但却无法直连 Gemini，提示 地区不支持 ， location is not supported 等错误。

这是因为你的服务器 IP 虽然物理位置在海外，但被谷歌判定为中国大陆或香港地区，从而拒绝提供服务。俗称 谷歌送中 。

本文将教你用最简单的方法——咕咕助手一键脚本，给服务器中转一个干净的 IP（Cloudflare WARP），专门用来欺骗谷歌，解决 Gemini 的连接问题。

1. 什么是谷歌送中

送中是黑话，指谷歌（Google）的风控机制，通过 IP 数据库或用户行为分析，判定你购买的海外 VPS 的实际使用者位于中国大陆或香港地区。一旦 IP 被判定为送中，你将无法使用仅限特定地区的服务（如 Google Gemini），或者在使用 YouTube 时无法享受到对应地区的权益（如 Premium）。

2. 如何判断谷歌送中

最直接的判断方法是查看你的服务报错信息。如果在使用 Gemini API 时返回 User location is not supported for the API use，那基本就是 IP 问题。

脚本测试：可以使用咕咕助手内置的测试脚本进行测试，在服务器终端中粘贴以下命令运行脚本（运行过一次后以后就不用复制命令了，输入 gugu 即可呼出菜单）:
```
bash <(curl -sL gugu.qjyg.de/vps)
```
1. 输入 4 回车（系统安全与工具）。
2. 输入 1 回车（测试脚本）。
3. 输入 1 回车（Region 流媒体解锁测试）。
4. 输入 0 回车（只进行跨国平台检测）。
5. 查看 Google Gemini 这一项的结果，应当是 YES ，如果是 NO 或 (CN) 则可能被送中了（如果有 IPV4、IPV6 两个结果，以 IPV4 的结果为准）。
Gemini API 测试：如果你拥有一个 Gemini API KEY，可以使用咕咕助手发出一个对话请求，和上面的脚本测试互相印证，结果可能不同，最准确还是要看你实际使用的那个服务能不能用。回到咕咕助手主菜单。
1. 输入 4 回车（系统安全与工具）。
2. 输入 1 回车（测试脚本）。
3. 输入 2 回车（API 接口连通性测试）。
4. 输入 1 回车（测试 Gemini API）。
5. 输入你的 Gemini API KEY。
6. 如果能拉出模型列表就没问题，如果送中会返回错误代码 400 和 User location is not supported for the API use.
7. 输入模型名称或直接回车，会消耗一条额度和 Gemini 对话进行实测，返回 Gemini 讲的笑话就是正常。

如果你能使用你服务器的 IP 上网，还可以直接打开网页进行测试：

Gemini 网页版：浏览器直接访问 gemini.google.com，如果提示“Gemini 目前不支持你所在的地区”，就是送中了。有时候不会显示这个但是对话会报错，点开左下角设置可以看到 IP 在中国。
PixPin_2026-01-13_19-22-14.jpg
Google 搜索引擎：浏览器访问 https://www.google.com/search?q=1 ，拉到底看显示的 IP，显示大陆/香港地址就是送中。
PixPin_2026-01-13_19-09-26.jpg

3. 为什么会送中

很多原因，送中是一送一整个 IP 段的，也就是说和你买了相同 IP 段的邻居们，有一个滥用的或者不谨慎使用的，就全体送中了。以下行为都有可能送中，但实际机制大概只有谷歌知道：

用户开启了定位/位置信息。
用户允许了根据所在地展示个性化内容。
用户的安卓手机谷歌三件套收集的数据。
谷歌根据搜索习惯、语言偏好、大数据学习到的偏好判定。有的傻（哔——）为了 Youtube 没广告故意把 IP 弄送中，一个人害一个 IP 段，你拉他送无穷无尽。

4. 什么是 warp

Cloudflare WARP 是 Cloudflare 提供的一个免费 VPN 服务。Cloudflare 的 IP 是公共 IP，谷歌是不会把它送中的，所以能够保证可用性。套了 warp 相当于给服务器开梯子，会损失一点速度，虽然 Cloudflare 拥有全球节点，会自动选最近的节点，但是毕竟中转了一下。

5. 什么是 warp-docker

直接在宿主机用官方方式或脚本部署的 warp 无法接管部分 docker 应用的流量，博主是 docker 狂魔，如果你不用 docker，现在可以退出去搜 warp 脚本了。

warp-docker 可以解决这个问题，docker 应用和宿主机应用都可以使用。

使用的镜像来自 github 作者 cmj2002，请给作者点一个免费的 star： https://github.com/cmj2002/warp-docker

一键部署使用的工具是我的免费开源项目 咕咕助手，请在 github 帮我点一个免费的 star 支持一下，谢谢： https://github.com/qingjue723/st-tools

6. 占用

内存约 75M，硬盘约 475M。

7. 前提条件

一台能正常 SSH 连接的云服务器（SSH 工具/1Panel 宝塔面板的终端均可）。
- 相关文章：《云服务器重装系统、查看 IP、放行端口与 SSH 连接》

二、咕咕助手一键配置 warp-docker

此章节适用于已经使用咕咕助手部署过酒馆或 ais2api 的用户。如果你是手动部署或使用其他方式部署的应用，或者你不是酒馆或 ais2api 用户，请跳过此节看第三节。

1. 运行脚本

在服务器终端中粘贴以下命令运行脚本（运行过一次后以后就不用复制命令了，输入 gugu 即可呼出菜单）:

bash <(curl -sL gugu.qjyg.de/vps)

2. 一键为酒馆配置 warp

回到咕咕助手主菜单。

输入 3 回车（应用运维管理）。
输入 1 回车（酒馆运维管理）。
输入 9 回车（代理配置管理）。
输入 1 回车（自动配置 Warp 代理）。
配置成功后状态会变为 已启用 ，酒馆已经自动重启，无须手动重启。可以直接进酒馆验证。

如遇问题请在运维菜单或 1panel 中查看 warp 和酒馆的日志。

3. 一键为 ais2api 配置 warp

和酒馆同理，不赘述了。

如遇问题请在运维菜单或 1panel 或 web 控制台中查看 warp 和 ais2api 的日志。

三、一键单独部署 warp-docker

此章节与上面的第二章节做一个即可，适用于任意方式部署的任意应用，通过咕咕助手快速创建一个 WARP 容器。

回到咕咕助手主菜单。

输入 2 回车（应用部署中心）。

如果没安装 docker 可以在此安装 docker（选官方源）。

输入 6 回车（部署 Warp）。
安装路径： 回车。
访问端口： 回车 。

安全警告不要在云服务商的防火墙（安全组）放行这个端口！我们是内部使用，不需要放行端口。如果对外暴露，可能会被扫描并被他人盗刷流量。

部署成功会显示访问地址，存下来。忘记了可以在 Warp 运维菜单中查看。
PixPin_2026-01-13_17-39-08.jpg

四、为其它应用配置 warp

根据应用的部署方式（Docker 或非 Docker），连接方式有所不同：

非 Docker 部署（直接在宿主机运行）：
- 代理地址使用：http://127.0.0.1:1080 或 socks5://127.0.0.1:1080 。
Docker 部署（容器化运行）：
- 方法 A（推荐）： 将应用容器加入 warp 网络，然后使用 http://warp:1080 或 socks5://warp:1080。
- 方法 B（备用）： 使用 Docker 网桥 IP，通常是 http://172.17.0.1:1080 或 socks5://172.17.0.1:1080（配置简单，无需加入网络，但不保证 100% 能用，且性能略低）。

以下是几种常见应用的修改示例：

1. 仅需修改 Compose 文件的应用

以 ais2api 为例，我们需要添加环境变量 HTTP_PROXY 系列，并将容器加入 warp 网络。修改后需执行 docker compose up -d 重启或重建容器。（或在 1PANEL 编排修改，保存即自动重建）

services:
  ais2api:
    container_name: ais2api
    image: ellinalopez/cloud-studio:latest
    ports:
      - "8889:7860"
    env_file:
      - app.env
    volumes:
      - ./auth:/app/auth
    restart: unless-stopped
# --- 新增部分开始 ---
    environment:
      - HTTP_PROXY=http://warp:1080
      - HTTPS_PROXY=http://warp:1080
      - ALL_PROXY=http://warp:1080
    networks:
      - warp
networks:
  warp:
    external: true
# --- 新增部分结束 ---

需同时修改 Compose 和应用配置文件的应用

以酒馆为例，酒馆自身支持在配置文件中定义代理。

修改 config.yaml

找到 config.yaml 文件，修改 requestProxy 字段：

enabled: 改为 true
url: 改为 socks5://warp:1080

PixPin_2026-01-13_18-11-46.jpg

2. 修改 docker-compose.yml 并重启容器

将酒馆容器添加进 warp 网络：

services:
  sillytavern:
    container_name: sillytavern
    # ... 其他原有配置 ...
    restart: unless-stopped
# --- 新增部分开始 ---
    networks:
      - warp
networks:
  warp:
    external: true
# --- 新增部分结束 ---

需同时修改 Compose 和 Web 控制台的应用

以 gcli2api 为例，该应用可以在 Web 界面设置代理。

修改 docker-compose.yml 并重启容器

同样是将容器加入 warp 网络：

services:
  gcli2api:
    image: ghcr.io/su-kaka/gcli2api:latest
    container_name: gcli2api
    # ... 其他原有配置 ...
# --- 新增部分开始 ---
    networks:
      - warp
networks:
  warp:
    external: true
# --- 新增部分结束 ---

打开 gcli2api 的 web 控制台，切到配置管理页面。
PixPin_2026-01-13_18-22-15.jpg
在代理设置一栏填写 warp 的容器访问地址 socks5://warp:1080 。
PixPin_2026-01-13_18-22-50.jpg
拉到最上面点保存配置，不必重启容器。

非 docker 部署，参考 docker 部署的示例，省去修改 compose 文件部分，访问地址改为填写 http://127.0.0.1:1080 或 socks5://127.0.0.1:1080 即可。

记录学习双拼一个月

Wed, 10 Dec 2025 16:00:00 GMT

一、从全拼换双拼的原因

一个月前偶然了解到双拼，这是一种中文输入方法，打一个字只需要敲两下键盘。

比如 “双拼” 这两个字用全拼需要敲 9 次键： shuangpin ，双拼则只需要 4 次： ulpb 。如此一来击键次数少了很多，打同样的字自然会轻松很多，用时上限也会短很多。

比起速度，我更在意的是打字减负。我的习惯不太好，习惯打很全的全拼，不习惯简拼。因为小指无力的缘故，我是不用小指敲键盘的。每天打字量还是很大的，打多了会感觉有些累。

二、介绍双拼

双拼其实很简单，汉语拼音是由声母、韵母和音调组成的，这里不用看音调，只看声母和韵母。

1. 声母

声母
b	p	m	f	d	t	n	l
g	k	h	j	q	x	zh	ch
sh	r	z	c	s	y	w

声母除了 zh、ch、sh 以外都是单字母，单字母直接按照本来键位即可，zh、ch、sh 则分配给了 v、i、u 三个键位。

2. 韵母

韵母
a	o	e	i	u	ü	ai	ei
ui	ao	ou	iu	ie	üe	er	an
en	in	un	ün	ang	eng	ing	ong

韵母中，单字母同样按照本来键位，双字母则分配给了不同的键位，这就是学双拼主要需要熟悉的东西啦。

这里贴一张小鹤双拼官网给的键位图：

3. 拼写示例

双拼：
- 双 是 sh 和 uang，sh = u，uang = l，所以 ul = shuang。
- 拼 是 p + in，p = p，in = b，所以 pb = pin。
- 就是这么简单，恭喜你学会双拼啦！
零声母字：
- 这里约定使用韵母的首字母当作声母。
- 比如 啊（a），韵母的首字母（只有一个字母）是 a，拼起来就是 aa。
- 昂（ang），韵母的首字母是 a，ang 在双拼里是 h，所以 ah = ang。

4. 助记诗

关于韵母，官网给到一篇助记诗：


Qiu	Wei	Ruan	T_ue_ve	Yun	U_shu	I_chi
秋	闱	软	月	云	梳	翅
Song	_iong	Dai	Fen	Geng	Hang	J_an
怂	恿	带	粉	更	航	安
Kuai	_ing	Liang	_uang	Zou	Xia	_ua
快	迎	两	王	揍	夏	蛙
Pie	Cao	V_zhui	_v	Bin	Niao	Mian
撇	草	追	鱼	滨	鸟	眠

三、学习经历

这里是小鹤双拼的官方网站，我只在官网学过，本文的所有内容都可以在官网找到：小鹤音形 - 官方网站

了解了双拼的原理之后，我在小鹤网盘（也可以在官网找到）下载了 双拼键位练习 和 小鹤专用添雨跟打器 两个工具。

屏幕左边放着口诀，右边打开 双拼键位练习，它会给出一个拼音让你打，键盘上有提示但我没看，想不起来我就看口诀，一直默念，这样第一天练习了 3 个小时、第二天练习了 2 个小时，我的练习就到此为止了，正式开始使用双拼。

添雨跟打器 我下了没用，只是用来打文章测速，一周左右测一次看看进度。

我的全拼原始速度是 125 字/分钟，使用双拼的当天是 46 字/分钟，非常着急，长这么大从未打字这么焦急过，手跟不上心里想的。但是无所谓，就坚持。

头两天，遇到工作着急的地方我切过两次全拼和客人沟通，仅这两次，后来直到现在我再没有用过全拼了。

我的速度增长很慢，因为我就是硬用，从不练习，但是我的心态好了很多，不再焦急，可能也算一种修身养性吧。

第 4 天：57 字
第 8 天：70 字
第 10 天：79 字（感觉不影响日常使用了）
第 14 天：85 字
第 22 天：99.5 字
一个月：108 字

虽然还没有恢复速度，但是我真切的感觉到打字轻松了很多。

四、进阶

虽然敲键少了，但还是要选字，选字会影响一部分打字流畅度，特别是生僻字。所以小鹤双拼还有进阶玩法——小鹤音形，我还没开始学，应该就是把字形加进去，减少重码率。接下来有空的时候我回去学习音形啦。

这段学习经历还是很让人开心的！

五、输入法

对了，我使用的输入法完全没有因为小鹤而变化，Windows 是 RIME 小狼毫，安卓是语燕，它们都自适配小鹤方案，惊喜的是语燕还有辅助提示。

其实对我来说手机更难以适应，我手机打字一直是 9 键，一下子换全键盘好不习惯，总感觉我的手太大了，经常按错。不过相信熟能生巧，慢慢适应就好啦。

博客搬家啦！

Tue, 09 Dec 2025 16:00:00 GMT

博客大装修啦！

是的我又装修了，整个大搬家，生命在于折腾！

image.png

最明显的，换了整个架构应该看出来了，我能力很有限，适配原站、改装小功能折腾了我一个多礼拜。以及，我从 Vercel 搬到服务器上了，试试看吧，如果不行再随时搬回。

一切都刚刚开始，我会一点点完善，没事常来看看，会常看常新的！

如果发现什么 bug 希望可以告诉我！也可以给我提使用意见。

让我和它一起成长~

很遗憾，上线 10 分钟服务器就炸了！灰溜溜回到 Vercel 。不是博客问题，是我服务器太满了，以后有机会再看看吧~

解决终端网络问题

Tue, 02 Dec 2025 16:00:00 GMT

我不教翻墙，本文只是简单讲解技术原因，仅供学习，请大家遵纪守法。

很多人的浏览器或其他软件已经可以正常访问受限网络，但是酒馆、git 命令、gemini cli、gemini antigravity、及其 2api 项目却仍然无法连接。

这是因为普通的代理模式（http、socks5）只适合看网页等轻度使用，无法接管很多终端程序。我们的酒馆等相关应用都是普通代理模式管不了的。

要让终端走代理，有两种主要方法：

代理软件开启 tun 模式。
为终端或应用手动配置代理信息。

一、开启 TUN 模式 (推荐)

开启 tun 模式比较简单，在自己使用的代理工具里找到相关选项，打开就行了。至于自己手搓的就不讲了，会自己搓 yaml 的也不会看这个文章吧。

开启后，我在酒馆里直连 gemini api key，发了一条消息，可以看到网络连接走的是 tun 而不是 http。

二、手动配置代理

1. 通过咕咕助手配置

首先要知道你代理工具使用的端口，比如图中是混合端口 7890，就是不管 HTTP 还是 SOCKS 共用 7890 端口，找到混合端口或 HTTP 端口就可以。

咕咕助手有一个 配置网络代理 的选项，这个功能就是让咕咕助手打开的应用走代理，必须输入正确的 HTTP 端口才能正常使用。

注意：如果输入了错误端口，或者配置完没开代理软件，那会导致咕咕助手无法联网。要恢复正常联网，要么清除咕咕助手代理配置走直连或 TUN 模式，要么配置正确端口的代理。

2. 在终端手动配置 (临时)

如果不用咕咕助手，可以进终端手动配置。这些都是一次性的配置，关闭终端后就失效了，每次打开新的终端都需要重新输入一遍。请将 7890 换成你自己的端口。

PowerShell

$env:http_proxy="http://127.0.0.1:7890"
$env:https_proxy="http://127.0.0.1:7890"

CMD

set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890

Termux

export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"

三、在应用配置文件中设置代理（以酒馆为例）

另外很多项目是支持在配置文件里配置代理的，比如酒馆可以在 config.yaml 文件找到代理配置 requestProxy：

只要把 enabled 改成 true，然后在 url 里填写自己端口号的 http 或 socks5 代理地址就可以了，比如 http://127.0.0.1:7890。

填完如图：

酒馆启动时如果能看到自己填写的代理信息，就代表配置成功了。

这样配置后，我发了一条消息可以看到连接类型是 https，这和 tun 模式就不同了，因为我们让酒馆走了 http 代理。

gcli2api 安卓/Windows一键部署，无须key免费使用gemini

Fri, 28 Nov 2025 00:00:00 GMT

建议不要再使用！！！ 2026-03-03 谷歌封号严重，请勿使用各种反代项目。

更新 2025-12-18 gcli2api 项目已聚合反重力渠道，可使用 gemini3、claude 4.5 opus 等模型，更新咕咕助手、然后在咕咕助手菜单中更新 gcli2api 即可使用。

前言

本文介绍咕咕助手 3.0 版本加入的新功能，聚合了 gcli2api 项目，可以和酒馆同时本地部署，只需要 google 账号即可免费使用 gemini、claude 高级模型。

gcli2api 是聚合了 google cli 和 google 反重力两个渠道的 2api 项目，额度和 gemini api key 和 ais2api 等渠道是独立的，一个 google 账号可以同时拥有多渠道，多份额度。

所有 2api 项目均有封号风险，不接受风险请勿使用。

对 gemini 各渠道有疑惑可查看相关文章：新手酒馆速通攻略及入门扫盲

google cli 就是这个工具：

google 反重力即 google antigravity 就是这个工具：

image.png

此项目代替你和这两个工具对话并生成外接 API。

gcli2api 项目来自 github 作者 su-kaka，请给作者点一个免费的 star： https://github.com/su-kaka/gcli2api

咕咕助手是我的免费开源项目，请在 github 帮我点一个免费的 star 支持一下，谢谢： https://github.com/qingjue723/st-tools

咕咕脚本和 gcli2api 是两个完全独立的项目，咕咕助手仅作为聚合工具提供 gcli2api 的安装引导，不修改任何原始代码，不涉及任何衍生内容。

前提条件

一个能正常使用的 Google 账号，需要创建过项目。
- 相关文章：注册 google 账号与申请 gemini 密钥

安装和后续使用都需要纯净的 大陆香港以外 的网络环境。
- 以能够正常打开 gemini 网页版看到对话页面而不是跳转到“地区不符合”页面为准。https://gemini.google.com
- 遇到网络问题请看：解决终端网络问题
仅供使用咕咕助手部署的酒馆使用，无法保证和其他部署方式适配。
- 安卓咕咕助手相关文章：安卓一键部署酒馆
- PC 咕咕助手相关文章： Windows 一键部署酒馆

pro 账号（学生 pro、家庭 pro 都算）可以调用 gcli 渠道的 gemini-3-pro-preview ，普通账号可以调用 gemini-2.5-pro 。
普通账号和 pro 账号（学生 pro、家庭 pro 都算）均可使用反重力渠道的 gemini3、claude 4.5 opus 等模型，但普通账号额度可能非常少，谷歌每天都在收紧，具体请自己尝试。
被封账号、风控账号可能无法使用。

安装

确保安卓咕咕助手版本在 3.0 或以上、PC 咕咕助手版本在 4.2 或以上。如果不是可以在助手里更新。（PC 老版本更新功能有 BUG，可能需要重新下载，把 咕咕助手.bat 和 pc-st.ps1 替换成新下载的即可，热更新功能已在 4.2 版本修复。）
输入 10 额外功能 回车。
输入 1 gcli2api 回车。
输入 1 安装/更新 回车。
看到致敬原作者的声明按引导输入 yes 回车，等待安装完成，会自动弹出 web 面板。

获取 GCLI 凭证

输入默认密码 pwd 进入面板。
点击 获取认证链接。
下方会显示很长一串 认证链接，点击跳转到 Google 登录页面，登录自己的 Google 账号。
登录后会显示 OAuth authentication successful!，切回刚刚的 gcli2api web 面板页面。
点击 获取认证文件按钮。
显示 ✅ 认证成功！，就是成功了。凭证文件已经自动储存进去了。划到最上面点击 文件管理 菜单可以看到储存的凭证，或者在 MT 管理器 gcli2api 目录下的 creds 文件夹中也可以看到。

获取认证文件失败

如果获取认证文件失败，请切回登录后显示 OAuth authentication successful! 的那个页面，完整复制此页面的网址。
切回 gcli2api web 面板页面，展开 无法回源？试试快捷方式 ，把刚刚的网址粘贴进去。
点击 从回调 URL 获取凭证 ，显示 从回调 URL 认证成功，凭证已保存 就是成功了。
还是不行往后翻错误自查排查网络问题。

获取反重力凭证

切到 Antigravity 认证 菜单，参考获取 GCLI 凭证，同样方法获取凭证即可。

管理面板中有很多功能可以自行查看。

在酒馆中连接

项目默认会随酒馆一起启动，回到咕咕助手主菜单按照平常的方式启动酒馆。

点击菜单栏 左二插头图标，打开 连接设置 标签页。
API: 选择 聊天补全。
聊天补全来源: 选择 自定义（兼容 OpenAI）。
自定义端点（GCLI 渠道基础 URL）: http://127.0.0.1:7861/v1。（注意是 http 不是 https）
自定义端点（反重力渠道基础 URL）: http://127.0.0.1:7861/antigravity/v1。（注意是 http 不是 https）
自定义 API 密钥: pwd。
提示词后处理: 选择 严格。
自动连接到上次的服务器：勾选。
点击连接按钮。绿灯处显示 有效 或 Valid 就是连接成功，显示其他的都是连接失败，停下来排错。
在 可用模型 列表中，选择需要的模型。
点击右上 保存配置 按钮，下次就不用重新输了，需要勾选的内容看下图。
如果选择的是假流式模型必须在预设中勾选 流式输出 按钮才有效哦，记得按保存。
确认正常使用后，gcli2api 的相关网页都可以关掉，以后也不用再打开，每次启动和以前一样直接启动酒馆即可。（PC 需保持终端窗口开启）

错误自查

部署过程中的错误

90% 是网络问题。

网络问题请看：解决终端网络问题

使用过程中的错误

90% 是谷歌账号问题。

请查看日志并把日志发给 AI 解读。

多端通用：
- 管理页面查看日志：http://127.0.0.1
Windows 端：
- 黑色终端窗口可以查看日志。
- 再开一个咕咕助手可以进入 额外功能菜单 ，按照菜单查看 运行状态 等。
安卓 Termux：

Termux 可以并行多个窗口，只需要点击 Termux 下方的按钮三横杠按钮呼出侧边栏，再点击 NEW SESSION 即可。
通常情况下咕咕助手会在新窗口内自启。
进 额外功能菜单 ，可以按照菜单查看 gcli2api 的运行状态和运行日志 。

海外云服务器 docker 部署 ais2api

Fri, 21 Nov 2025 00:00:00 GMT

一、前言

1. 简介

本文介绍如何在海外云服务器上用咕咕助手脚本一键 docker 部署 ais2api，只需一个 google 账号即可免费使用最牛逼的 gemini-3‑pro‑preview 模型。

ais2api 是 Google AI Studio 网站的 2api 项目，额度和 gemini api key 、gcli、反重力等渠道是独立的，一个 google 账号可以同时拥有多渠道，多份额度。

所有 2api 项目均有封号风险，不接受风险请勿使用。

对 gemini 各渠道有疑惑可查看相关文章：新手酒馆速通攻略及入门扫盲

Google AI Studio 就是这个网站： https://aistudio.google.com/prompts/new_chat

此项目代替你和这个网页对话并生成外接 API。

项目来自 github 作者 iBUHub，请给作者点一个免费的 star：

github.com

GitHub - iBUHub/AIStudioToAPI: A wrapper that exposes Google AI Studio as OpenAI, Gemini, and Anthropic compatible APIs.（一个将 Google AI Studio 封装为兼容 OpenAI / Gemini / Anthropic 风格 API 的工具）

A wrapper that exposes Google AI Studio as OpenAI, Gemini, and Anthropic compatible APIs.（一个将 Google AI Studio 封装为兼容 OpenAI / Gemini / Anthropic 风格 API 的工具） - iBUHub/AIStudioToAPI

https://github.com/iBUHub/AIStudioToAPI

一键部署使用的工具是我的免费开源项目 咕咕助手，请在 github 帮我点一个免费的 star 支持一下，谢谢： https://github.com/qingjue723/st-tools

2. 占用

占用较大，约 500M 内存，2.15G 硬盘。如果要和酒馆共存，建议服务器内存 3G 以上。

3. 前提条件

一台能正常 SSH 连接的云服务器（SSH 工具/1Panel 宝塔面板的终端均可）。
- 相关文章：《云服务器重装系统、查看 IP、放行端口与 SSH 连接》
大陆及香港以外的云服务器。
一个能正常使用的 Google 账号。
- 相关文章：注册 google 账号与申请 gemini 密钥

普通账号可用、无须 pro，谷歌每天都在收紧，具体额度请自己尝试。

二、云服务器部署

1. 运行脚本

在服务器终端中粘贴以下命令运行脚本（运行过一次后以后就不用复制命令了，输入 gugu 即可呼出菜单）:

bash <(curl -sL gugu.qjyg.de/vps)

2. 部署

输入 2 回车（应用部署中心）。

如果没安装 docker 可以在此安装 docker（海外选官方源，大陆一路回车）。

输入 5 回车（部署 ais2api）。
安装路径： 回车。
访问端口： 10000-65535 之间任意输入。
管理密码： 回车。
部署成功：记下访问地址和密码。
放行端口：如果使用面板防火墙，请去放行相应的 tcp 端口。ufw 防火墙不用管，因为 ufw 拦不了 docker 端口。

3. 获取凭证与使用

浏览器打开刚刚记下的访问地址（即 http://服务器IP:端口），输入密码进入网页管理后台。
在网页后台的账号管理位置点击添加凭证按钮，进入 VNC 页面。
PixPin_2026-02-22_17-44-20.jpg
这里卡是正常的。点击右上角的 Get Started ，登录自己的 google 账号。这里面复制粘贴快捷键是没用的，如果需要复制粘贴，点击下面那个键盘按钮。
PixPin_2026-02-22_17-49-51.jpg
选择最新的 pro 模型，对话试试能不能用，能聊就能用。
PixPin_2026-02-22_17-55-31.jpg
能正常回复，点保存。
PixPin_2026-02-22_17-56-36.jpg
保存成功后会回到管理面板，并看到添加的账号进来了。点切换按钮，激活这个账号。
PixPin_2026-02-22_17-57-29.jpg
如果有更多账号，同样加进去就行了。
接口调用：
- Web 面板/Gemini 接口/OpenAI 接口：即管理面板的网址，即 http://服务器IP:端口 。
- 访问密码/密钥：即进入管理面板时填的密码，即部署成功时显示的密码。

酒馆不会自动补全 /v1 ，所以 OpenAI 格式需加 /v1 ，即 http://服务器IP:端口/v1 。

三、咕咕助手管理

主菜单输入 3 回车（应用运维管理）。
输入 3 回车（ais2api 运维管理）。
在这里可以重启、更新、看日志、卸载等。
如果看的是本教程的旧版本部署的旧版 ais2api（需要 windows 获取凭证的版本），也可以在这里迁移到新镜像。
PixPin_2026-02-22_18-01-15.jpg

四、1Panel 管理重启、更新、看日志

在容器 -> 容器中可以看到 ais2api 项目。
更改了配置文件需要重启才能应用更改，或者出了问题也可能需要重启试试，点开状态按钮，点重启。
如果官方更新了新版本，点更多 -> 升级，强制拉取镜像 勾上，然后确认，等待拉取镜像成功后就自动切换到新版本重启了。不会改变用户数据。
日志可以查看日志排查问题。

注册 google 账号与免费申请 gemini 密钥

Tue, 18 Nov 2025 00:00:00 GMT

一、注册 Google 账号

想要拥有自己的 Gemini API，必须拥有一个 Google 账号。

Google 近期风控严格，账号注册门槛高，注册成功后新号的限制也很多。很多新账号的 API KEY、Google CLI、Google Antigravity 等是无法使用的。不过能注册就先注册上，养养号，说不定以后能用。

1. 准备工作：检测网络环境

检测网站：
- IPPure: https://ippure.com (检测 IP 纯净度)
- ipdata: https://ipdata.co (检测 IP 地理位置和风险评分)
判断标准：
- 在 IPPure 上，IPPure 系数 越低越好。
- 在 ipdata 上，TRUST SCORE 越高越好。
- 尝试切换网络节点并刷新页面，直至找到一个综合评分较高的节点。

2. 开始注册

手机注册（推荐）

前提条件是手机上有 Google APP 或者 Gmail（IOS 需要外区账号、安卓需要谷歌框架）。

进入 Google APP 或者 Gmail，点击右上角头像。
切换账号 -> 添加其他账号 -> 创建账号 -> 个人用途。
按照页面提示完成注册。
- 如果网络环境足够好，Google 可能不会要求验证手机号。
- 如果需要验证，通常中国的 +86 手机号也可以成功接收验证码。

浏览器注册

在浏览器中打开一个新的“无痕窗口”或“隐私窗口”。
访问 Google 账号注册页面：https://accounts.google.com/signup
按照页面提示完成注册。
- 如果网络环境足够好，Google 可能不会要求验证手机号。
- 如果需要验证，通常中国的 +86 手机号也可以成功接收验证码。

Google 账号的注册门槛较高，成功注册后请妥善保管。建议绑定所有可用的安全验证方式（如备用邮箱、两步验证等），以降低被封禁的风险。

二、申请 API 密钥

由于 Google 额度收紧，目前免费账号已经没有最好的模型了，flash 和 gemma 还可以用。

手机操作请开启浏览器的 PC 模式。

成功登录 Google 账号后，访问 Google Cloud 平台创建项目：https://console.cloud.google.com/projectcreate
直接点击创建（项目名称可保持默认，也可自己取名字）。
左上角这里是 选择项目 的地方，确保目前选择的是新建的项目（后续再 创建新项目 也是点这里）。
左上角三横杠展开侧边栏，点击进入 API 和服务 页面。
进入库页面。
搜索 GEMINI API，点击启用。
在凭证页面，点击 创建凭据 -> API 密钥 -> 创建，将 AIzaSy 开头的那串密钥保存好。
可重复创建 1-3 个项目，每个项目各 1 个密钥。每个项目的额度独立，但过多项目会增加封禁风险。
进入 AI Studio API KEY 管理页面：https://aistudio.google.com/apikey
点击 导入项目 按钮，将刚刚创建的项目全选导入。
这里的密钥和刚刚创建的是一样的，还没复制的话也可以在这里复制保存。注意图中 配额层级 必须显示 免费层级 而不是 不可用。
- 备注：如果显示 不可用，说明 Google 账号被风控了（新号常见情况），通常很多相关服务都会收到影响，暂未发现其他解决方案。
查看额度：速率限制里的 RPD 是每日额度，每天下午 3-4 点刷新。

三、直连酒馆

原生的 Gemini API Key 使用 Gemini 格式的 Google 官方 API 接口和申请来的 Key 进行连接。官方端口在酒馆里已经预设好啦，所以 API 接口不需要我们填写，只需要填密钥。

遇到网络问题请看：解决终端网络问题

中国大陆和香港地区的网络无法直接连接 Gemini API 。

点击菜单栏 左二插头图标，打开 连接设置 标签页。
API：选择 聊天补全。
聊天补全来源：选择 Google AI Studio。
Google AI Studio API 密钥：填入对应的密钥，只能填写一个 (示例: AIzaSyxxxxxxxxxxx)。
提示词后处理：选择 严格。
自动连接到上次的服务器：勾选。
点击 连接 按钮。绿灯处显示 有效 或 Valid 就是连接成功，显示其他的都是连接失败，停下来排错。
在 Google 模型 列表中，选择需要的模型。
Tip
截至 2026-04-09，免费可用模型包括 gemma-4-31b-it、gemini-3-flash-preview 和 gemini-3.1-flash-lite-preview。按能力大致是：gemini-3-flash-preview（日 20 条）>gemma-4-31b-it（日 1500 条）>gemini-3.1-flash-lite-preview（日 500 条）。
点击右上 保存配置 按钮，下次就不用重新输了，需要勾选的内容看下图。

四、自建中转

这不是必须的，如果你有非常多的 key 嫌手动切换麻烦，或者想用大陆、香港原生网络访问，可以考虑。

自建中转可以实现的主要功能有：绕过地区限制、多 Key 管理和负载均衡、多渠道聚合、接口转换、假流式输出、分发 等。简单来说就是如果你有了多个可以正常使用的 Google API KEY，并且你有上述需求，那你可以考虑用中转管理一下。

不同的工具功能不同，按需选择单个或多工具配合使用。

部署中转通常需要一个服务器，如果你有自己的服务器最好部署在自己的服务器上。如果没有，那么可以薅一些免费服务如 Render、Alwaysdata 等（相当于掰你一个服务器的小角落）。

萌新通常的需求是 绕过地区限制 和 多 Key 管理，这里推荐 hajimi 项目，除了上述两个功能以外，它还有 接口转换 和 假流式输出 的功能。

Render 免费部署 Hajimi 轮询
- 简介：解决 Gemini 无法直连 的问题，多 key 的 轮询管理 和 假流式输出。
Render 等平台免费服务一键保活
- 简介：免费平台的应用在闲置后会自动休眠，本文分享了我的保活项目，避免被休眠。

五、2API

每种 2API 的配额与通过 Google AI Studio 申请的官方 API 密钥是独立的，可以都要，这样额度更多，一个不能用了换另一个。 2API 只需要 Google 账号，不需要 API KEY。

所有 2api 项目均有封号风险，不接受风险请勿使用。

gcli2api 安卓/Windows 一键部署，无须 key 免费使用 gemini
- 简介：【咕咕助手】安卓/Windows 一键部署 google cli 和反重力双渠道的 2api 项目。免费使用 gemini-3-pro-preview 和 claude-4.5-opus 只需一个 google 账号。
海外云服务器 docker 部署 gcli2api
- 简介：【咕咕助手】云服务器 docker 一键部署 google cli 和反重力双渠道的 2api 项目。免费使用 gemini-3-pro-preview 和 claude-4.5-opus 只需一个 google 账号。
海外云服务器 docker 部署 ais2api(build 反代)
- 简介：【咕咕助手】云服务器 docker 一键部署 google ai studio 的 2api 项目。免费使用 gemini-3-pro-preview 只需一个 google 账号。

新手酒馆速通攻略及入门扫盲

Thu, 13 Nov 2025 00:00:00 GMT

本文只做一件事：让新手迅速部署并聊上。会顺手带一点点必要科普，但不在这篇里展开讲解，先玩上最重要。

酒馆是什么

SillyTavern，俗称酒馆，一个免费开源的角色扮演用空壳前端，可以连接各厂家的 AI 大模型来聊天。

GitHub - SillyTavern/SillyTavern

https://github.com/SillyTavern/SillyTavern

与 AI 官方网页版（如 chatgpt 官网、gemini 官网）相比，酒馆有更细致的人设管理、提示词管理、更强的记忆力、更好的沉浸感。
与商业 AI 角色扮演聊天软件相比，酒馆部署在你自己的地盘，对话内容只有你自己（和你连接的 AI 大模型）知道，没有审查、更私密、更自由。
此外，酒馆还能自由换模型、装扩展。有非常大的自定义空间，本文只教如何快速入门，先玩上再说。

使用咕咕助手快速部署

根据你的设备不同，选择不同的部署位置。部署完记得回来继续往下看。

安卓手机

部署在你自己的手机上，然后用浏览器网页的形式打开本地的酒馆程序。

安卓一键部署酒馆

部署完成后可以通过局域网（同一个 WIFI 内）让局域网内其他任何设备访问安卓手机上的酒馆。

酒馆手机电脑局域网互访

Windows 电脑

部署在你自己的电脑上，然后用浏览器网页的形式打开本地的酒馆程序。

Windows 一键部署酒馆

部署完成后可以通过局域网（同一个 WIFI 内）让局域网内其他任何设备访问 Windows 电脑上的酒馆。

酒馆手机电脑局域网互访

iOS 、纯血鸿蒙与云服务器

iOS 、纯血鸿蒙系统比较封闭，无法用常规手段在手机上部署酒馆。还有一种情况是设备比较多，想把数据统一放在一个地方。

方案一：部署在安卓手机、Windows 电脑上，然后通过局域网用 iOS 手机访问其他设备上的酒馆。
方案二：购买自己的云服务器，也就是租一台有公网 IP 的电脑并在上面部署酒馆。这样你可以用任何设备在任何时间地点直接通过网页打开酒馆，数据也都存在那台服务器上。

云酒馆三部曲请按顺序观看：

云酒馆服务器选购指南
- 简介：如何挑选适合玩酒馆的云服务器？海内外服务器有何区别？这里有详细的配置建议和产品推荐。
云服务器重装系统、查看 IP、放行端口与 SSH 连接
- 简介：购买服务器后，需要进行重置系统、设置安全组（放行端口）以及使用 SSH 工具连接登录等基础操作。
Linux 云服务器一键部署酒馆
- 简介：使用一键脚本，为云服务器进行简单的安全加固并部署酒馆。

警惕酒馆租赁与代搭

酒馆租赁：最差的一种。酒馆搭在别人自己的服务器上，数据、权限、日志全在别人手里。对方如果要看、要拿、要导出你的 API、角色卡、聊天记录，基本就是光明正大地干坏事。
代搭：和租赁不完全一样。要是搭完以后，对方还保留着你的厂商登录信息、服务器 ssh、面板权限、酒馆权限之类的任意一种访问方式，那安全性就没好到哪里去，只是从光明正大变成了偷偷摸摸。但如果搭完以后你自己把所有安全信息都改掉，或者代搭那边确实把权限删干净，那这一项就是安全的。

但代搭的问题不只这一项。陌生人代搭常见的坑还有：

服务不正规：承诺和实际不符，什么都能答应，出了问题就开始扯皮。
偷工减料：机子乱推、配置乱做、备份不做、安全不做，当下能用就算交差。
社区责任：如果你用了社区作品，也可能顺带把别人的心血送出去。

所以：强烈不推荐租赁酒馆，也不建议去闲鱼等平台找陌生人代搭。请先看教程，真的不难。

（如果你信任我，可以联系我。但我平时较忙，不一定能及时回复，且精力有限，仅限实在无法自行解决的朋友。）

部署后的基础配置

酒馆是一个空壳前端，装完还需要一些配置才能用起来。下面按顺序做，不要跳步骤。

一、安装实用扩展

酒馆很多好用功能都靠扩展实现。代码渲染几乎算必装，不装的话你看到的可能就是一坨原始 HTML。并且它也是很多预设内置脚本的前置依赖，包括我们一会要用的教材预设。

安装前：

SillyTavern聊天界面，显示未经渲染的原始HTML代码

安装后：

SillyTavern聊天界面，显示经过扩展渲染后正确显示的HTML表格

安装代码渲染扩展 - 酒馆助手

作者 KAKAA | 官方文档

点击菜单栏 三个方块图标，打开扩展标签页。
点击 安装扩展 按钮。
SillyTavern扩展界面，高亮显示了安装扩展按钮
在弹窗中的上面一行输入框内输入扩展安装地址，然后点击 Install just for me（仅为自己安装） 即可安装。
大陆版：
```
https://gitlab.com/novi028/JS-Slash-Runner
```
海外版：
```
https://github.com/N0VI028/JS-Slash-Runner
```
SillyTavern安装扩展弹窗，显示了输入URL的文本框和安装按钮
看到绿色弹窗代表安装成功，酒馆助手会自动生效，无须配置。
SillyTavern界面，显示扩展安装成功的绿色提示信息

其他扩展

其他扩展的安装方式和酒馆助手完全一致，拿到作者给的安装地址照着装就行。

聊天草稿守护：服务器云酒馆必装，本地酒馆也推荐装。网络问题、保存失败这类情况很常见，它可以在出错时提醒并重试，也可以导出聊天记录，缓解丢记录问题。

仓库地址：

大陆版：

https://gitee.com/canaan723/gugu-chat-draft-guard

海外版：

https://github.com/qingjue723/gugu-chat-draft-guard

记忆表格：作者木悠 | 官方文档

大陆版：

https://gitee.com/muyoou/st-memory-enhancement

海外版：

https://github.com/muyoou/st-memory-enhancement

由于大陆无法直连 GitHub，作者有时会同时给海外和大陆两个安装地址，注意别填错。如果只有 GitHub 地址，装不动的话，可以加代理前缀。

在原始的 GitHub 地址前面，加上 https://hubproxy-advj.onrender.com/ 这个前缀。

# 原地址
https://github.com/SillyTavern/SillyTavern-Extras
# 加速后
https://hubproxy-advj.onrender.com/https://github.com/SillyTavern/SillyTavern-Extras

关于加速地址该加速地址由博主维护，仅用于酒馆扩展下载，请勿滥用。失效可以找我要别的。

二、连接 AI 模型

酒馆就是个程序，它是不会说话的，真正说话的是 AI 模型，你需要准备两样东西：AI 模型的 API 接口 和密钥。

关键词

API 接口：酒馆去哪和 AI 模型说话。
密钥：酒馆怎么向接口证明自己有权限和 AI 模型说话。

API 的获取与使用

领取新手 API

跟着本站教程部署酒馆的新手，可以进群凭咕咕助手主菜单界面截图领取 3-5 天入门试用 API，先玩上，在此期间去获取自己的 API 就不着急了（个人分享，不提供付费 API 服务）。
群会一直踢人给需要帮助的人留位置，不需要帮助也不交流请不要进，也不要同时进两个群。

好模型不是随时都有，有时只有入门模型，请理解。

想自己申请 API，直接看这篇：注册 google 账号与申请 gemini 密钥

在酒馆中连接 API（公益站通用）

你会得到一个网址形式的 API 接口 和一个一串符号的密钥。请按以下文字顺序一步步设置。

点击菜单栏 左二插头图标，打开 连接设置 标签页。
API: 选择 聊天补全。
聊天补全来源: 选择 自定义（兼容 OpenAI）。
自定义端点（基础 URL）: 填入 API 接口，地址应以 /v1 结尾，如果不是那就加上 /v1。
自定义 API 密钥: 填入密钥。
提示词后处理: 选择 严格。
自动连接到上次的服务器：勾选。
点击连接按钮。绿灯处显示 有效 或 Valid 就是连接成功，显示其他的都是连接失败，停下来排错。
在 可用模型 列表中，选择你想用的模型。
点击右上 保存配置 按钮，下次就不用重新输了，需要勾选的内容看下图。
SillyTavern连接设置页面，展示了保存配置时需要勾选的选项
再次点击菜单栏 左二插头图标，关闭 连接设置 标签页。

三、导入教材预设

这里提供一个简单的入门教材预设，直接导入即可。

下载预设：点击下载

本预设为新手入门预设，极简，轻量。
有其他需求可以自己添加条目或缝合其他预设喜欢的条目，或者更换更好的预设。
本预设授权所有正常玩家任意二改、分发，无须署名，有借鉴需要可直接把文件喂给 AI。

导入预设

首先确保你没有跳步骤，已经安装了酒馆助手扩展并连接了 AI 模型。
点击菜单栏 左一图标，打开 预设管理 标签页。
取消勾选符号，这样就不会因为切换预设而断开 API 连接。
点击导入按钮，打开预设 .json 文件。
SillyTavern预设管理界面，高亮显示了导入按钮
弹窗提示一律点是。导入后看到预设名字出来了，下拉可以看到具体条目。
再次点击菜单栏 左一图标，关闭 预设管理 标签页。
我们不用手动开关条目，在聊天框上方可以看到控制台按钮，点开之后按自己的喜好随时切换即可。

四、开始聊天测试

现在已经可以和酒馆默认角色 Seraphina 对话了，来发一条试试。

点击菜单栏 右一身份证图标，打开 角色卡 标签页。
SillyTavern主界面，高亮显示了角色卡标签页的图标
可以看到默认角色 Seraphina，点击她，进入角色详情页面。
SillyTavern角色列表，显示了默认角色Seraphina
再次点击菜单栏 右一身份证图标，关闭 角色卡 标签页。
现在可以看到对话页面了，在底部输入框内和她对话吧。
SillyTavern聊天界面，展示了与角色Seraphina的对话窗口和底部的输入框
点击纸飞机按钮发送后，发送按钮会变成停止按钮，耐心等它重新变回纸飞机。
如果发生截断（生成不完整，原因一般是触发审核），或 AI 没按格式输出，或你单纯看着不满意，点击左下角 三条横杠 按钮，点 重新生成 就可以重 roll。前文对 AI 的影响巨大，AI 会学前文说话，千万不要保留不好的内容哦。开始新聊天 可以开新对话，旧对话会保留在 管理聊天文件 里。
SillyTavern聊天菜单，高亮显示了重新生成和开始新聊天等选项

五、创建角色卡

如果你想自己快速做一个能直接开聊的新角色，直接看这篇：

《酒馆扩展：咕咕助手 - 角色卡生成器》

课后扩展：社区角色卡与自动解析

导入角色卡

角色卡通常是 .png 或 .json 格式，两者内容没区别。部分发布页会额外放一个单独世界书，那一般是备用的，单导入角色卡即可。导入后如果弹窗问你要不要一起导入配套世界书正则什么的，一律点是。

安卓-角色卡导入

SillyTavern弹窗提示，询问用户是否导入与角色卡关联的世界书

之后小地球图标会变绿，代表已经自动开启了世界书。不需要额外设置，也不需要手动切换。

SillyTavern角色详情页，显示绿色的世界书图标，表示已激活

多开局角色卡

很多角色卡不止一个开局，首页可能只是介绍，后面才是真开局。在新聊天里点气泡左右下角的箭头就可以切换。

SillyTavern聊天界面，展示了用于切换角色不同开场白的箭头按钮

自动解析隐藏思维链

很多预设使用的不是原生思维链，需要开启自动解析才能隐藏思维链。如果你看到如图这样，前面有一长串由一对 <thinking> 标签或者其他标签包裹的思考过程，就是漏思维链了，需要开启自动解析。

SillyTavern聊天界面，由于正则被关闭，AI回复中的思维链现在是可见的

点击菜单栏 左三 A 图标，打开 高级格式化设置 标签页。
拉到最底下，勾选 自动解析，展开 推理内容格式化，点击新建按钮，名字随便起，比如 thinking。
SillyTavern高级格式化设置，展示了如何开启自动解析并新建一个推理内容格式化规则
前缀填写 <thinking>，后缀填写 </thinking>，点击保存。

image.png
关闭标签页后，旧消息里的思维链还在，这是正常的。重 roll 一条，新消息里思维链就会被收进思考过程，不会漏出来。

SillyTavern聊天界面，展示了自动解析功能将思维链折叠成一个可展开的“思考过程”

自动解析吃的是预设作者设定的标签，不同预设标签可能不同，所以前后缀不一定都是 <thinking>。
如果思维链不是放在最开头（点开小铅笔可以查看原始内容确认），这个功能就用不了通常作者会配备隐藏思维链的正则。

社区资源获取

酒馆资源一般在 Discord 的社区中获取。Discord 是一个类似于贴吧的平台，要加入酒馆的资源分享吧，你需要从邀请链接进入。

不过在此之前，你需要确保自己可以访问外网，然后用邮箱注册自己的 Discord 账号。

网页版：Discord - 专为游戏和快乐打造的群聊
安卓 APP 版：Google Play 商店下载。
iOS APP 版：外区账号 Apple Store 下载。

进入社区需要邀请链接，由于博主是单机党，不太关注社区，所以大家可以自行获取社区邀请链接。

酒馆版本回退

Sun, 02 Nov 2025 16:00:00 GMT

安卓和 windows 的咕咕助手自带此功能，本文适用于云酒馆及不使用我脚本的安卓和 windows。

咕咕助手安卓版：安卓一键部署酒馆
咕咕助手 windows 版： Windows 一键部署酒馆

正常操作不会改变用户数据。但建议养成好习惯，在执行不熟悉的操作前备份数据，以防万一。

点击跳转对应平台

安卓 Termux

一、打开 Termux。

如果有脚本正在运行，需要先退出，确保行首是 ~ $ 才能输入命令。
退出脚本：可按脚本菜单的退出选项，或点亮屏幕下方的 ctrl 按钮，然后用输入法输入英文 c （相当于 ctrl+c 的组合键）。

二、进入 SillyTavern 的根目录。不同安装方式的路径可能不同。执行命令后，确保行首路径有变化。

cd SillyTavern

PixPin_2025-11-03_15-36-43.png

三、获取所有版本标签信息。

git fetch --all --tags

如果报错 fatal: unable to access 'https://github.com/SillyTavern/SillyTavern.git/': Recv failure: Connection was reset
表示网络无法连接到 GitHub。可以尝试开启网络工具的 TUN 模式，或执行以下命令更换为镜像仓库地址，再重复 git fetch --all --tags 这一步操作。
git remote set-url origin https://hubproxy-advj.onrender.com/SillyTavern/SillyTavern.git

四、列出版本标签，在这里面找到自己想要回退的版本。

列出所有标签：
```
git --no-pager tag --sort=v:refname
```
或只列出 1.13 系列的标签：
```
git --no-pager tag -l "1.13.*"
```

五、切换版本，将版本号改为上一步中列出的标签之一。例如，切换到 1.13.4 版本：

git checkout 1.13.4

如果报错 error: Your local changes to the following files would be overwritten by checkout
表示酒馆的程序本体被修改过（例如登录页美化代码），或依赖包不匹配（如 package-lock.json 文件），错误下面会列出具体的报错文件。备份自己改过的文件，然后执行以下命令放弃所有修改，再重复 git checkout 1.13.4 这一步操作。此操作不会影响 data 目录下的用户数据。
git reset --hard

六、安装新版本对应的依赖。

npm install

七、按正常方式启动 SillyTavern 即可。

Windows

一、在文件资源管理器中打开 SillyTavern 的根目录，清空地址栏的路径，输入 cmd 并按回车，直接在当前目录打开命令提示符。

PixPin_2025-11-03_15-51-22.png

二、获取所有版本标签信息。

git fetch --all --tags

如果报错 fatal: unable to access 'https://github.com/SillyTavern/SillyTavern.git/': Recv failure: Connection was reset
表示网络无法连接到 GitHub。可以尝试开启网络工具的 TUN 模式，或执行以下命令更换为镜像仓库地址，再重复 git fetch --all --tags 这一步操作。
git remote set-url origin https://hubproxy-advj.onrender.com/SillyTavern/SillyTavern.git

三、列出版本标签，在这里面找到自己想要回退的版本。

列出所有标签：
```
git --no-pager tag --sort=v:refname
```
或只列出 1.13 系列的标签：
```
git --no-pager tag -l "1.13.*"
```

四、切换版本，将版本号改为上一步中列出的标签之一。例如，切换到 1.13.4 版本：

git checkout 1.13.4

如果报错 error: Your local changes to the following files would be overwritten by checkout
表示酒馆的程序本体被修改过（例如登录页美化代码），或依赖包不匹配（如 package-lock.json 文件），错误下面会列出具体的报错文件。备份自己改过的文件，然后执行以下命令放弃所有修改，再重复 git checkout 1.13.4 这一步操作。此操作不会影响 data 目录下的用户数据。
git reset --hard

五、安装新版本对应的依赖。

npm install

六、按正常方式启动 SillyTavern 即可。

云服务器 Docker 部署

一、打开 1panel 面板，进入容器 > 编排页面。二、点击 sillytavern 条目对应的编辑按钮。三、修改 image 行，将标签从 latest 更改为具体的版本号。例如，要回退到 1.13.4 版本，参考以下更改。

# 更改前
image: ghcr.io/sillytavern/sillytavern:latest
# 更改后
image: ghcr.io/sillytavern/sillytavern:1.13.4

四、修改完成后，点击确认按钮，等待新的镜像拉取成功。

大陆服务器可能因国际网络原因导致拉取速度较慢或无法拉取。

不知道有那些版本点击跳转 github 页面查看版本

云服务器 Git 部署

待续

优选域名提升网站的国内访问速度

Thu, 23 Oct 2025 16:00:00 GMT

很多部署在云服务器上的项目，因为距离远、线路烂，直连效果并不好。Cloudflare 免费套餐给大陆的 CDN 节点通常只有两三个，如果本地网络到这几个节点的连接不佳，访问速度可能比直连还慢。本文将演示通过一些配置让 Cloudflare 拥有更多 CDN 节点来优化访问。

效果对比

我分别在晚高峰测试了直连、仅开启小黄云和优选后的路由情况。重点关注最后一行的 丢包率（通不通）和 平均延迟（快不快）。

直连

美国服务器，被墙了直连不了，100% 丢包。

小黄云

开启默认 CDN 后，可以连接了，但丢包 26%，延迟 629ms。

优选后

优选后，丢包 0%，延迟 205ms，这是一个美国服务器的正常延迟了。

前提

1 个或 2 个 Cloudflare 账号，并准备一个支付方式（用于防止滥用，正常使用不产生费用，没有外币卡就绑 Paypal）。
- 登录地址：https://dash.cloudflare.com/
- 进入控制台后可在右上角切换语言。
- Paypal 注册地址: https://www.paypal.com
2 个托管在 Cloudflare 的域名。
- 参考文章: 免费申请 dpdns.org 和 qzz.io 域名
服务已绑定好域名并可以正常访问。
- 参考文章: 用 1Panel 给项目绑定域名

风险提示

优选域名违反 Cloudflare 的服务条款，官方有权封号处理。
目前尚未出现因优选域名被封号的案例。
如果不放心，可将绑定服务的域名放在大号上，违规的工具域名放在小号上。工具域名所在账号需要绑定支付方式。

操作演示

为了方便对比和留个后悔药，建议另外给你的服务绑定一个域名（前缀不一样就行，一个服务可以绑很多个域名）。确保你有两个可以访问这个服务的地址，地址 1 保留，地址 2 用来优选。

如果你的服务器在美国，无法直连或直连不稳定，效果可能会很好。
如果你的服务器位于亚太地区，或者线路本身很好，那么延迟（快慢）可能会反向优化，要提升稳定性（断不断线）可能需要更多的挑选尝试，更换优选域名。
不过你可以同时保留直连和优选两个域名，哪个好就用哪个。

为便于区分，下文假设：

你拥有的 2 个根域名分别是 大号.com 和 小号.com 。
其中你要优化的服务，绑定在 大号.com 下面，你的服务的完整地址（即地址 2）是 youxuan.大号.com 。
小号.com 作为工具域名使用。

大号.com 和 小号.com 可以托管在相同或不同的 Cloudflare 账号里，风险主要在 小号.com 所在的账号。

1. 配置工具域名 (小号.com)

导航至 小号.com 的 DNS > 记录页面，添加一条 A 记录。
- 类型: A
- 名称: origin
- IPv4 地址: 服务器 IP
- 代理状态: 开启小黄云
再添加一条 CNAME 记录。
- 类型: CNAME
- 名称: cdn
- 目标: www.visa.cn (这是优选域名，不一定适合每个人，后续如果效果不好可以回来更换)
可以用这个 cdns.doon.eu.org ，最近发现的感觉不错。 —— 2026-01-02
- 代理状态: 关闭小黄云
导航至 SSL/TLS > 自定义主机名 页面。首次使用需点击 启用 Cloudflare for SaaS 并绑定支付方式。
在 回退源 输入框中输入 origin.小号.com，点击 添加回退源。点刷新按钮，等待回退源状态变为 有效。
点击 添加自定义主机名。在 自定义主机名 字段填写 youxuan.大号.com（要优选的服务完整域名），其他默认，点击 添加自定义主机名。

2. 验证主域名 (大号.com)

待跳转回 自定义主机名 页面，底部可以看到刚添加的 youxuan.大号.com。此时证书状态是待验证，展开它，可以看到两条用于验证域名所有权的 TXT 记录。如果只看到一条，点刷新。
导航至 大号.com 的 DNS > 记录页面，复制粘贴添加上面那 2 条 TXT 记录。图为第一条的示例，另一条同理。

3. 完成连接

回到 小号.com 的 自定义主机名 页面，刷新检查验证状态。验证过程可能需要十几秒到几分钟，两条记录也不一定会同时验证成功。耐心等待，直到 证书状态 和 主机名状态 均显示 有效。
再次回到 大号.com 的 DNS > 记录页面。添加一条 CNAME 记录。如果提示无法添加，说明已有名称为 youxuan 的 A/AAAA/CNAME 记录，找到它然后修改。
- 类型: CNAME
- 名称: youxuan
- 目标: cdn.小号.com
- 代理状态: 关闭小黄云
配置完成。CDN 传播需要时间，半小时后可实际体验。如果不理想，可以开无痕模式排除缓存干扰，或尝试更换其他优选域名。

优选域名来源

CMLiussss： https://cf.090227.xyz/
微测网： https://www.wetest.vip/page/cloudflare/cname.html
cnae： https://www.cnae.top
vps789： https://vps789.com/cfip/?remarks=domain

继续优选其他服务域名

同一服务器上的域名

在 小号.com 的 自定义主机名 页面，点击 添加自定义主机名 按钮，填写新的要加速的服务域名并添加。
在 大号.com 的 DNS 页面，添加 TXT 记录以验证所有权。
在 大号.com 的 DNS 页面，将新域名 CNAME 到 cdn.小号.com，并关闭小黄云。

不同服务器上的域名

在 小号.com 的 DNS > 记录页面，为新服务器添加一条 A 记录。
- 类型: A
- 名称: origin-japan (随便取个不重复的)
- IPv4 地址: 新服务器的 IP
- 代理状态: 开启小黄云
在 小号.com 的 自定义主机名 页面，点击 添加自定义主机名 按钮，填写新的要加速的服务域名。注意，这里的自定义源服务器 选项需要选择 自定义源服务器，并输入刚刚创建的 A 记录地址，如 origin-japan.小号.com。
在 大号.com 的 DNS 页面，添加 TXT 记录以验证所有权。
在 大号.com 的 DNS 页面，将新域名 CNAME 到 cdn.小号.com，并关闭小黄云。

为无面板防火墙的云服务器安全配置 ufw 与 Docker

Mon, 20 Oct 2025 16:00:00 GMT

前言

很多海外特价机不带网页防火墙，用 ufw 来当防火墙会遇到一个问题：Docker 会无视 ufw 规则，直接把端口暴露到公网。

安全原则是，端口放行最小化，能少开就少开、能不开就不开，所以必须想办法解决这个问题。

折腾了一圈，感觉最优雅的办法是用 ufw-docker 脚本。

我的使用场景是：Debian 系统、Docker Compose 部署应用、1Panel 绑域名，如果场景相同可以继续看。

核心思路：分工合作

ufw: 只管主机本身。例如 SSH 端口、面板端口，以及各种主机上的服务端口。
ufw-docker: 只管 Docker 容器。精确管理 Docker 映射出来的容器端口。

第一部分：一次性初始化设置

一、ufw 初始化

安装 ufw
```
sudo apt update
sudo apt install ufw -y
```
设置默认策略 拒绝所有入站请求，放行所有出站请求。这是最基础的安全设置。
```
sudo ufw default deny incoming
sudo ufw default allow outgoing
```
放行基础服务端口

重要提示
在启用防火墙前，必须先为 SSH 等基础服务留门，否则会立即失联。必须将示例命令中的端口改为自己实际的端口。
```
# 示例：假设 SSH 端口为 55555
sudo ufw allow 55555/tcp

# 示例：假设 1Panel 访问端口为 66666
sudo ufw allow 66666/tcp
```
启用 ufw
```
sudo ufw enable
```
看到提示后，输入 y 并回车。

二、ufw-docker 初始化

本项目来自 github 作者 chaifeng，请点一个免费的 star 支持一下：

github.com

GitHub - chaifeng/ufw-docker: To fix the Docker and UFW security flaw without disabling iptables

To fix the Docker and UFW security flaw without disabling iptables - chaifeng/ufw-docker

https://github.com/chaifeng/ufw-docker

下载脚本并授权

sudo wget -O /usr/local/bin/ufw-docker https://github.com/chaifeng/ufw-docker/raw/master/ufw-docker
sudo chmod +x /usr/local/bin/ufw-docker

自动安装 该命令会自动修改 ufw 的配置文件，使其能够接管 Docker 的网络规则。
```
sudo ufw-docker install
```
重载防火墙使其生效
```
sudo ufw reload
```

至此，所有初始化工作完成。

第二部分：日常使用示例

一、管理容器端口 (使用 ufw-docker)

场景： 部署了一个名为 sillytavern 的 Docker 应用，需要对外放行其 8000 端口。

放行端口 首先通过 docker ps 确认容器名为 sillytavern，然后执行：
```
sudo ufw-docker allow sillytavern
```

检查状态 使用 ufw status numbered 查看所有规则，确认新规则已添加。

Status: active

     To                         Action      From
     --                         ------      ----
[ 1] 55555/tcp                  ALLOW IN    Anywhere
[ 2] 66666/tcp                  ALLOW IN    Anywhere
[ 3] 172.19.0.2 8000/tcp        ALLOW FWD   Anywhere                   # allow sillytavern 8000/tcp sillytavern_default
...

删除规则 应用绑定域名了、或者卸载了不再使用了，通过序号精确删除规则。
```
sudo ufw delete 3
```
或者通过这个命令删除 sillytavern 这个容器的全部相关规则。
```
sudo ufw-docker delete allow sillytavern
```

场景二：管理主机端口 (使用 ufw)

场景： 通过 1Panel 的 OpenResty 部署了网站，需要放行 80 和 443 端口。

1Panel 的 OpenResty 容器的网络模式是 host ，直接使用主机网络，因此可视作主机上的服务，使用 ufw 而非 ufw-docker 命令。

放行端口 直接使用 ufw 命令为主机放行端口：
```
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
```

检查状态 再次查看规则列表，会发现多了两条 ufw 的规则。

Status: active

     To                         Action      From
     --                         ------      ----
[ 1] 55555/tcp                  ALLOW IN    Anywhere
[ 2] 66666/tcp                  ALLOW IN    Anywhere
[ 3] 80/tcp                     ALLOW IN    Anywhere
[ 4] 443/tcp                    ALLOW IN    Anywhere
...

删除规则 如果不再需要任何网站，同样按序号删除。

重要提示
如果要一次性删除多条规则，从序号大的开始删，避免序号错乱！
```
# 先删序号大的
sudo ufw delete 4
# 再删序号小的
sudo ufw delete 3
```

第三部分：常用命令

1. 通用命令

功能	命令	说明
查看状态	`sudo ufw status`	显示当前所有规则
查看带序号的状态	`sudo ufw status numbered`	日常使用或配合删除查看序号
按序号删除规则	`sudo ufw delete <序号>`	推荐，删除任何来源的规则
启用防火墙	`sudo ufw enable`
禁用防火墙	`sudo ufw disable`
重新加载规则	`sudo ufw reload`

2. 主机规则 (ufw)

功能	命令
放行端口	`sudo ufw allow <端口>/<协议>`
拒绝端口	`sudo ufw deny <端口>/<协议>`

3. 容器规则 (ufw-docker)

功能	命令
放行容器所有已发布端口	`sudo ufw-docker allow <容器名>`
精确放行容器端口	`sudo ufw-docker allow <容器名> <端口>/<协议>`
删除某容器相关的规则	`sudo ufw-docker delete allow <容器名>`
查看已放行的容器规则	`sudo ufw-docker status`
检查安装状态	`sudo ufw-docker check`

1Panel 为重要目录配置每日自动备份

Fri, 17 Oct 2025 16:00:00 GMT

为保证服务器突发故障时损失最小，对重要文件夹进行服务器外备份是非常必要的。

本文以酒馆为例。对酒馆来说，最优先推荐的肯定是咕咕助手 git 备份工具的自动上传用法，这种方法可以保证每日自动上传、用户数据永远不丢失、可以任意回滚到任何时间点的版本（这是 git 最强的地方之一）。

相关文章： 酒馆用户数据云端备份与多端同步

那为什么还会有这篇文章呢，git 虽然强但并不是在任何情况下都完美的，本文主要解决以下几个痛点：

酒馆非 git 部署。（咕咕助手仅适配跟我教程部署的 docker 云酒馆）
使用我的 git 备份工具但需要用于多端同步。（咕咕助手的手动多端同步和自动备份目前只能二选一）
除了用户文件夹以外还想要备份更多的内容。（咕咕助手仅备份用户文件夹）
备份其他服务

使用 1panel 的自动备份可以完美规避以上问题，相对应的缺点是：

没有 git 那样强大的版本控制功能。
根据备份文件的大小和存储空间的限制，可能只能存放近一段时期的备份包，无法下到太久以前的数据。
备份包是压缩包，不下载下来无法方便的打开查看内容。
当然，也可以互为补充备份双管齐下更加稳妥。

如果它满足你的需求就继续看下去吧。

一、备份工具推荐与对比

本文推荐 3 个备份工具，分别是 Cloudflare R2 和 缤纷云 S4。优缺点如下：

1. Cloudflare R2（稳定可靠但要绑卡、下载大文件不方便）

额度：
- 存储空间：10G（留意不要超、超了要付钱。一般个人的酒馆数据也就 50M-200M，且备份会自动删除旧文件，因此是可控的）
- 上传/删除/修改请求： 100 万次/月（对个人来说约等于无限）
- 下载/预览/列出请求： 1000 万次/月（对个人来说约等于无限）
- 下载流量： 完全免费
优点：
1. 全球访问友好、大陆访问友好。
2. 非常可靠！
3. 几乎完全免费，特别是下载流量不限制非常难得。
缺点：
1. 网页端下载单个 500M 以上的文件困难，如果真的很大可以分块上传，或者用其他方式下载。
2. 需要绑定支付方式。绑定支付方式是为了防止滥用，实际上只要别存超 10G 就是永久免费的。可以使用 paypal 或国际信用卡绑定。

paypal 是什么相当于是国际上的“支付宝”，填真实信息即可。不需要信用卡，普通的储蓄卡都可以，只要能绑支付宝的卡就能绑这个。

2. 缤纷云 S4（大陆速度快、下载有限制）

额度：
- 存储空间： 50G （虽然很大方，但是由于下载有限制所以并不感觉比 CF 好）
- 请求： 10 万次/月
- 下载流量： 5G/日 10G/月（就是每日只能下载 5G、每月只能下载 10G 的数据，不要用超哦，用超要付钱）
优点：
1. 大陆访问友好。下载速度快。
2. 不用绑支付方式（但需要实名认证）
3. 可靠程度中等
缺点：
1. 是大陆商业服务
2. 是大陆商业服务所以需要实名认证
3. 日和月下载流量都有限制，不能肆无忌惮下载

缤纷云作为 CF R2 的替代，在不愿意 paypal 或绑卡，且能接受小心下载的情况下使用。

此服务的扣款方式是从余额扣款，充值余额最低 50 元，哪怕被扣一毛钱，也只能最低充值 50 元。
欠费情况下是停机状态，无法对存储桶进行任何操作。如果你是流量欠费，那还好说，欠费通常不会有变动了。如果是存储欠费，那就糟了，你无法删存储，所以欠费会一直累积，只能及时充值。
欠费一个月后会清空存储，无法恢复。
缴清欠费后可继续使用服务。

S3 存储桶的 "S3" 和缤纷云 S4 的 "S4" 是什么意思？ S3 来源于亚马逊率先推出的对象存储服务 AWS S3，由于是开创者且应用广泛，后来 S3 的 API 成为了行业标准，市面上大部分的对象存储服务都兼容 S3 API。
S4 其实就是缤纷云给自己产品取的牛逼名字，可能寓意比 S3 还多 1 点吧，实际上它还是一个兼容 S3 API 的对象存储。
其它厂商也都会给自己的对象存储取一个与众不同的名字，比如开创者 AWS（亚马逊）的对象存储就叫 S3、Cloudflare 的叫 R2、Backblaze 叫 B2、腾讯云叫 COS、阿里云叫 OSS。

4. 跳转对应章节

选好备份地点后，使用博客目录跳转至对应章节。

二、Cloudflare R2 配置方法

1. 准备工作

一个绑了支付方式的 cloudflare 账号
- 注册地址：https://dash.cloudflare.com/sign-up
- 进入控制台后右上角可切换语言：
  Cloudflare 控制台右上角切换语言的截图
- 绑支付方式：https://dash.cloudflare.com/sign-up/r2 未绑定过支付方式的话，打开此页会要求绑支付方式（右上角可绑 PAYPAL）。已绑定过的话会直接可以创建存储桶。
- paypal： https://www.paypal.com

2. 操作步骤

(1) 获取存储桶信息

打开 cloudflare r2 页面：https://dash.cloudflare.com/sign-up/r2
点击 创建存储桶 按钮。
如下填写
- 存储桶名称：任意英文名
- 位置： 自动，当前不是亚太地区就改成亚太地区
- 默认存储类： 标准 填好点击 创建存储桶 按钮。
  Cloudflare R2 创建存储桶的表单截图
创建好存储桶后，点击左上角的 R2 对象存储 ，退回到 R2 主界面。
Cloudflare R2 存储桶页面，高亮显示返回 R2 主界面的链接
点击右上角的 管理 API 令牌 按钮。
点击 创建 Account API 令牌 按钮。
如下填写
- 令牌名称：任意
- 权限： 对象读和写
- 指定存储桶： 仅应用于特定存储桶，并在下拉框中选择刚刚创建的存储桶。其他默认，填好点创建。
  在 Cloudflare 中创建 API 令牌的配置界面
创建成功后会跳转到很多密钥的页面，从上到下依次记录以下信息：
1. 存储桶名称
2. 访问密钥 ID
3. 机密访问密钥
4. 为 S3 客户端使用管辖权地特定的终结点 的 URL
  Cloudflare API 令牌创建成功后显示的密钥信息

(2) 在 1PANEL 中配置

面板设置 -> 备份账号 -> 添加，如下填写
- 名称：任意
- 类型：亚马逊 S3 云存储
- 模式：Virual Hosted
- Access Key ID：前面记录的 访问密钥 ID
- Secret Key：前面记录的 机密访问密钥
- 记住认证信息：勾选✔
- Region：auto
- Endpoint：前面选择 https，后面填前面记录的 为 S3 客户端使用管辖权地特定的终结点 的 URL
- Bucket：勾选 手动输入，填写前面记录的存储桶名称
- 存储类型：标准存储
- 备份目录：保持默认填好后点击确认。
  在 1Panel 中添加 Cloudflare R2 备份账号的配置界面
确认要备份的目录，以酒馆为例，打开酒馆根目录看一下结构。主要备份的就是 data 文件夹，其他看情况。我这个用户目录应该是相当大的了，有 2G+，不过打包之后只有 700+M，一般应该没这么大。这里我的是 docker 部署，根目录东西很少，都可以备份，只需要排除 _SillyTavern_Backups 文件夹就可以了，这个文件夹是咕咕助手从云端拉取时自动创建的，用来防止拉取的内容不对方便恢复的。那么我要备份的就是整个酒馆根目录，复制下酒馆根目录的整条路径，如 /home/qingjue/SillyTavern 。

Tip
如果不是按照我的教程部署的，可以只备份 data 文件夹，只复制 data 文件夹的路径就行。自己举一反三。

SillyTavern 应用程序的目录结构，高亮显示 data 文件夹
计划任务 -> 创建计划任务，如下填写
- 任务类型：备份目录/文件
- 任务名称：任意
- 执行周期：每天 / 4 小时 / 0 分钟（意思是每天凌晨 4
  执行）
- 备份：文件夹
- 备份内容：选择或填写要备份的目录，如 /home/qingjue/SillyTavern
- 备份账号：选择刚刚配置的 r2
- 保存份数：根据备份包大小和存储空间估算，份数超出会自动删除最早的备份。
- 排除规则：选择或填写不备份的内容，比如缓存、日志、本地备份等，会递归忽略。酒馆排除规则示例，复制进去之后一定要 点击添加规则按钮。包含缓存、用户文件夹内的自动小备份、日志文件、咕咕助手自动生成的本地备份
```
_cache
backups
*.log
_SillyTavern_Backups
```
填好之后点击确认。
在 1Panel 中创建备份目录计划任务的配置界面
点击刚创建的计划任务条目后边的执行按钮，立即手动备份一次，然后点击报告按钮查看日志。日志中会显示备份的目录、递归忽略的内容，以及备份成功还是失败。备份成功后回到 cloudfalre r2 存储桶页面可以查看和下载备份文件。我的包压缩后也有 700+M，大于 500M 在任何网页端下载都会有点吃力，如果你的包很大推荐尽量分块上传。cloudflare 在网页端下载后，不会弹出下载框，只能看到转圈，这是正常的，它会静默下载，下好了之后才会弹出保存框或者直接通过浏览器下载器保存。实测国内网络下载一个 570M 的包需要 1 分钟。实测下载 780M 的包失败了，太大的单个文件只能通过其他方式下载，反面教材，一般没这么大。
1Panel 计划任务执行成功的日志报告

Cloudflare R2 存储桶中显示的备份压缩文件

三、缤纷云 S4 配置方法

1. 准备工作

一个缤纷云账号（需实名认证）
- 注册地址： https://console.bitiful.com/login
- 实名认证地址： https://console.bitiful.com/users

2. 操作步骤

(1) 获取存储桶信息

打开缤纷云 S4 桶列表页面：https://console.bitiful.com/buckets
点击 创建桶 按钮，随便写个英文名，点击确定。
打开 AccessKey 页面： https://console.bitiful.com/accessKey
点击 添加子用户 按钮，随便写个英文名，点击确定。
会显示 Access Key 和 Secret Key ，记下来，只会显示一次。
记好后点击 设定权限 按钮，所有权限全部勾选✔。

(2) 在 1PANEL 中配置

面板设置 -> 备份账号 -> 添加，如下填写
- 名称：任意
- 类型：亚马逊 S3 云存储
- 模式：Virual Hosted
- Access Key ID：刚刚记下的 Access Key
- Secret Key：刚刚记下的 Secret Key
- 记住认证信息：勾选✔
- Region：auto
- Endpoint：前面选择 https，后面填 s3.bitiful.net
- Bucket：点击 获取桶 按钮，在下拉框中选择刚刚创建的桶。
- 存储类型：标准存储
- 备份目录：保持默认填好后点击确认。
  在 1Panel 中添加缤纷云 S4 备份账号的配置界面
确认要备份的目录，以酒馆为例，打开酒馆根目录看一下结构。主要备份的就是 data 文件夹，其他看情况。我这个用户目录应该是相当大的了，有 2G+，不过打包之后只有 700+M，一般应该没这么大。这里我的是 docker 部署，根目录东西很少，都可以备份，只需要排除 _SillyTavern_Backups 文件夹就可以了，这个文件夹是咕咕助手从云端拉取时自动创建的，用来防止拉取的内容不对方便恢复的。那么我要备份的就是整个酒馆根目录，复制下酒馆根目录的整条路径，如 /home/qingjue/SillyTavern 。

Tip
如果不是按照我的教程部署的，可以只备份 data 文件夹，只复制 data 文件夹的路径就行。自己举一反三。

SillyTavern 应用程序的目录结构，高亮显示 data 文件夹
计划任务 -> 创建计划任务，如下填写
- 任务类型：备份目录/文件
- 任务名称：任意
- 执行周期：每天 / 4 小时 / 0 分钟（意思是每天凌晨 4
  执行）
- 备份：文件夹
- 备份内容：选择或填写要备份的目录，如 /home/qingjue/SillyTavern
- 备份账号：选择刚刚配置的 r2
- 保存份数：根据备份包大小和存储空间估算，份数超出会自动删除最早的备份。
- 排除规则：选择或填写不备份的内容，比如缓存、日志、本地备份等，会递归忽略。酒馆排除规则示例，复制进去之后一定要 点击添加规则按钮。包含缓存、用户文件夹内的自动小备份、日志文件、咕咕助手自动生成的本地备份
```
_cache
backups
*.log
_SillyTavern_Backups
```
填好之后点击确认。
在 1Panel 中为缤纷云 S4 创建备份计划任务的配置界面
点击刚创建的计划任务条目后边的执行按钮，立即手动备份一次，然后点击报告按钮查看日志。日志中会显示备份的目录、递归忽略的内容，以及备份成功还是失败。备份成功后回到缤纷云存储桶页面可以查看和下载备份文件。缤纷云在网页端下载后，不会弹出下载框，看起来什么也没发生，这是正常的，耐心等待一会，它会静默下载，下好了之后才会弹出保存框或者直接通过浏览器下载器保存。实测 780M 的压缩包 40s 下完。记住不要超流量哦，一个月最多下载 10G。
1Panel 计划任务执行成功的日志报告

缤纷云 S4 存储桶中显示的备份压缩文件