Assute

Docker 安装与常用指令速查

Mon, 30 Mar 2026 03:52:53 GMT

这篇文章整理一份偏实用的 Docker 安装与命令清单，适合日常部署、维护和排查时直接查阅。

一、安装 Docker#

Terminal window

1
curl -fsSL https://get.docker.com -o get-docker.sh
2
sudo sh get-docker.sh

二、启动并设置开机自启#

Terminal window

1
sudo systemctl start docker
2
sudo systemctl enable docker
3
sudo systemctl status docker

验证是否安装成功：

Terminal window

1
docker --version
2
sudo docker run --rm hello-world

三、Docker 常用指令#

指令	说明
`docker --version`	基础：查看 Docker 版本
`docker info`	基础：查看 Docker 运行信息
`docker images`	镜像：查看本地镜像列表
`docker rmi -f IMAGE_ID`	镜像：强制删除指定镜像
`docker image prune -a`	镜像：清理未被容器使用的镜像
`docker ps -a`	容器：查看所有容器（含已停止）
`docker start ID`	容器：启动容器
`docker restart ID`	容器：重启容器
`docker rm -f ID`	容器：强制删除指定容器
`docker rm $(docker ps -aq -f status=exited)`	容器：批量删除已退出容器
`docker rm -f $(docker ps -aq)`	容器：强制删除全部容器
`docker-compose up -d`	Docker Compose：后台启动服务
`docker-compose down`	Docker Compose：停止并删除服务
`docker-compose logs -f`	Docker Compose：实时查看日志
`docker-compose restart`	Docker Compose：重启服务
`docker-compose up -d --build`	Docker Compose：重新构建并后台启动
`docker-compose ps`	Docker Compose：查看服务状态
`docker-compose down && docker-compose up -d --build`	Docker Compose：先销毁再重建启动

VS Code 连接服务器教程（Remote SSH）

Thu, 26 Mar 2026 03:50:21 GMT

这篇教程记录一下如何用 VS Code 连接远程服务器。

第一步：打开远程资源管理器，添加 SSH#

先打开 VS Code 左侧的远程资源管理器，然后点击添加 SSH 主机。

打开远程资源管理器并添加 SSH

第二步：输入连接命令#

基础连接命令：

Terminal window

1
ssh root@ip

如果你需要自定义连接端口，用这个命令：

Terminal window

1
ssh -p 22 root@ip

输入 SSH 连接命令

第三步：选择第一个配置文件#

VS Code 会提示把 SSH 配置保存到哪个文件，直接选择第一个即可。

选择第一个配置文件

第四步：连接服务器#

配置写入后，在远程资源管理器中点击对应主机并连接。

连接服务器

第五步：输入服务器密码#

首次连接会提示输入服务器密码，输入后回车。

输入密码

第六步：连接成功后打开文件夹#

连接成功后，点击打开远程文件夹。

连接成功后打开文件夹

第七步：选择目录并再次输入密码#

选择你要打开的服务器目录后，通常会再提示输入一次密码，输入即可。

选择目录并再次输入密码

完成#

到这里就完成了，你已经可以在 VS Code 里直接管理服务器文件了。

完成连接

Twitter Bot V2 部署与使用教程

Tue, 24 Mar 2026 14:51:58 GMT

这篇直接按实际部署流程整理。
按下面步骤操作，即可完成 Twitter Bot V2 部署，并把 X 的推文同步到 Telegram 群组。

一、先修改配置文件#

先打开项目里的配置文件：

1
config/settings.py

先把这里改掉：

1
# Telegram Bot Token
2
BOT_TOKEN =

改成实际使用的机器人 Token，例如：

1
# Telegram Bot Token
2
BOT_TOKEN = "机器人Token"

这个 BOT_TOKEN 是机器人启动的基础，不改的话项目没法正常跑起来。

二、启动项目#

启动方式有两种，任选一种即可。

方式一：Docker 一键部署#

在项目目录执行：

Terminal window

1
docker compose up -d

如果是第一次启动，或者改了镜像内容，也可以用：

Terminal window

1
docker compose up -d --build

方式二：安装依赖后用 Python 启动#

先安装依赖：

Terminal window

1
pip install -r requirements.txt

然后启动：

Terminal window

1
python run.py

这个命令会一起启动：

Telegram 机器人
后台管理页面

三、打开 Telegram 机器人#

项目启动后，先打开 Telegram 机器人。

机器人启动后，可以先获取主菜单，后面的所有操作基本都在这里完成。

菜单示例：

Twitter Bot V2 机器人主菜单

四、打开后台#

后台默认地址：

1
http://服务器IP:5000/login

默认管理员账号密码：

1
admin / admin123

后台登录页示例：

Twitter Bot V2 后台登录页面

登录进去后，先把后台基础设置配好。

五、设置套餐#

进入后台后，先去设置套餐。

套餐主要决定后面用户在机器人里看到的订阅信息和可购买内容，没有设置套餐的话，机器人端很多订阅相关功能不好用。

套餐设置页面示例：

Twitter Bot V2 套餐设置

六、设置支付接口和 TGAPI#

接着进入后台的系统设置页面，把支付接口和 TGAPI 一起设置好。

设置页示例：

Twitter Bot V2 支付接口和TGAPI设置

这里重点看两项：

易支付接口配置
Local Bot API 配置

这里的 Local Bot API，也可以直接理解成要配置的 TGAPI。

这一项一定要设置。

如果不设置，实际使用时只能稳定处理比较小的视频文件，大一点的视频很容易上传失败。
这一项建议直接按大文件场景配置，否则后面同步视频推文时很容易出问题。

TGAPI 的申请和搭建，可以参考站内之前的相关文章：

Telegram API 申请与部署教程（图文）

七、创建群组并给机器人权限#

后台和机器人都启动好后，接下来去 Telegram 里创建一个群组。

群组创建完成后，把机器人拉进群里，并给它管理员权限，同时开启管理话题权限。

第一步，打开机器人资料页，点击“添加到群组”：

点击机器人信息并添加到群组

第二步，选择前面创建好的群组：

选择刚创建的群组

第三步，给机器人管理员权限和管理话题权限：

设置管理员权限和管理话题权限

八、获取群组 ID 并添加群组#

机器人进群并设置好权限后，在群组中发送：

1
/getid

或者在菜单里直接点“获取群组ID”。

获取群组 ID 示例：

获取群组ID

复制这个群组 ID，然后回到机器人私聊窗口：

进入 群组管理
点击 添加群组
把刚刚复制的群组 ID 发给机器人

添加群组示例：

群组管理里添加群组

到这里，群组就算接好了。

九、添加要同步的用户名#

接着去 X 里复制需要保存推文的用户名。

然后回到机器人私聊：

进入 用户管理
点击 添加用户
发送 X 用户名

示例：

添加X用户名

十、添加 Cookie#

接下来设置 Cookie。

建议准备一个不用的 X 小号，或者单独注册一个新号，专门用来跑同步。
如果不想单独注册，直接购买一个便宜的 X 小号也可以，1 块钱左右的就够用。

大概流程就是：

在 X.com 登录一个不用的小号
按 F12 打开开发者工具
找到请求里的 Cookie
复制完整 Cookie 内容
回到 Telegram 机器人里设置

机器人里设置路径：

设置
Cookie 设置
设置 Cookie

然后把复制好的 Cookie 发给机器人。

操作示例：

进入Cookie设置

发送Cookie给机器人

十一、开始全量同步#

如果需要把某个 X 博主之前发过的内容一次性同步到群组，直接使用 全量同步。

全量同步开始后，会在目标群组里自动创建一个新的话题，话题名称就是这个博主的用户名。
后面这个博主同步过来的推文，都会统一发到这个话题里面，查看和管理都会更方便。

操作顺序如下：

进入 全量同步
选择群组
- 如果只设置了一个群组，这一步可能不会出现
选择要同步的用户名
选择同步内容
- 全部内容
- 仅同步视频推文
选择同步数量
- 自定义数量
- 或全部同步
确认后开始同步

全量同步示例：

全量同步操作

十二、定时更新#

如果不是只想同步一次，而是要持续订阅某个博主，就使用定时更新功能。

把想订阅的博主加进去后，机器人会定时获取新推文。

按当前这个版本的逻辑，默认是每小时获取一次。

这样后面博主有新内容，就会继续往对应的 Telegram 群组里发送。

十三、订阅信息#

前面在后台设置的套餐，后面都会在机器人里显示出来。

也就是说：

后台设置套餐
机器人里显示订阅信息
用户按套餐使用同步功能

十四、仓库地址#

项目地址：

GitHub: https://github.com/Assute/Twitter-Bot-V2

十五、最后提醒#

这套流程里最容易出问题的地方，基本就是下面这几个：

BOT_TOKEN 没改
后台套餐没设置
TGAPI / Local Bot API 没设置
机器人没有拉进群组
机器人没有管理员权限或管理话题权限
没有先添加群组就去同步
没有设置 Cookie 就去添加用户或抓推文

把这几步都配置好后，整体流程基本就能正常跑起来。

Telegram API 申请与部署教程（图文）

Mon, 23 Mar 2026 13:07:21 GMT

最近在接 Telegram 相关工具时，第一步就是先申请自己的 api_id 和 api_hash。
这个流程本身不复杂，但有一个重点一定要先记住：先准备家宽代理，不然很容易申请不成功。

一、先准备家宽代理#

申请 Telegram API 之前，先找一个可用的家宽代理。

这一点很关键：

一定要用家宽代理
不要直接用普通机房代理去申请
如果一直提交失败，先优先检查代理环境

简单来说，先把代理准备好，再去登录官方页面申请，成功率会高很多。

二、打开申请页面并登录#

打开 Telegram 官方申请地址：

https://my.telegram.org/apps

进入页面后，直接使用 Telegram 账号登录。

登录完成后，就会进入应用申请页面。

三、填写资料并提交#

进入申请页面后，资料可以按正常格式直接填写，提交即可，不需要写得太复杂。

可按实际用途简单填写应用名称和说明，能正常提交即可。

下面这张图就是填写资料的页面示例：

Telegram API 申请资料填写示例

提交完成后，系统会直接生成应用信息。

四、保存 App api_id 和 App api_hash#

申请成功后，页面会显示：

App api_id
App api_hash

这两个参数后面接 Telegram 相关程序、面板、脚本时都会用到，所以一定要马上保存好。

下面这张图就是申请成功后的页面示例：

Telegram API 申请成功示例

建议把这两个值保存到：

本地记事本
密码管理器
自己的配置文件

只要后面要接入 Telegram API，基本都离不开这两个参数。

五、Docker 一键部署 TGAPI#

申请到 App api_id 和 App api_hash 之后，就可以直接开始部署 TGAPI。

先执行下面这条命令：

Terminal window

1
mkdir -p ~/telegram-bot-api/data && docker run -d \
2
  --name telegram-bot-api \
3
  --restart always \
4
  -p 8081:8081 \
5
  -e TELEGRAM_API_ID=申请得到的api_id \
6
  -e TELEGRAM_API_HASH=申请得到的api_hash \
7
  -e TELEGRAM_LOCAL=1 \
8
  -v ~/telegram-bot-api/data:/var/lib/telegram-bot-api \
9
  aiogram/telegram-bot-api:latest

只需把下面两项换成申请得到的值：

TELEGRAM_API_ID=申请得到的api_id
TELEGRAM_API_HASH=申请得到的api_hash

如果想确认有没有正常跑起来，可以执行：

Terminal window

1
docker ps

六、部署完成后怎么用#

部署成功后，TGAPI 地址一般就是：

1
http://服务器IP:8081

七、注意事项#

最后再提醒几个重点：

第一优先级就是家宽代理
提交成功后立刻保存 api_id 和 api_hash
不要把自己的 api_hash 随便公开发出去
部署命令里的 api_id 和 api_hash 一定要换成申请得到的值
部署完成后，面板里要记得填写 TGAPI / Local Bot API
如果申请失败，先换代理环境再试

用 Go 写一个网站中转加速服务

Mon, 23 Mar 2026 07:34:31 GMT

最近把一个自用的网站中转加速服务整理成了一个独立项目，顺手开源出来，方便后面继续维护和部署。

项目地址：

GitHub: https://github.com/Assute/website-proxy

项目截图：

website-proxy 运行截图

这个项目是做什么的#

website-proxy 是一个用 Go 写的网站中转加速服务。

它的核心思路很简单：

用自己的服务器作为统一入口
把目标网站的访问请求转发出去
再把返回内容做必要处理后交给用户

这样做的好处是：

可以把目标网站统一挂到一个固定入口下
可以隐藏目标网站的真实访问地址
页面、静态资源和部分接口请求都可以继续走当前中转地址
部署方式比较轻，适合放在 Alpine Linux 服务器上运行

为什么要单独做这个服务#

很多时候，单纯做一个反向代理并不够。

因为真实页面在加载时，往往还会继续请求：

JS
CSS
图片
JSON 配置
接口地址
跳转地址

如果这些内容不处理，页面虽然打开了，但后续资源可能还是会跳回原站，或者因为地址不一致导致访问异常。

所以这个项目不只是“转发请求”，而是多做了一层“中转适配”：

重写页面里的链接和资源地址
重写部分接口返回内容
处理跳转头
调整部分 Cookie 和响应头

这样目标网站在中转地址下会更容易正常工作。

目前已经支持的内容#

现在这个项目主要包含这些能力：

固定入口访问，例如 /go
支持直接中转到指定目标地址
支持页面内容重写
支持部分静态资源和公共内容缓存
支持 config.json 配置
支持 OpenRC 启动方式
仓库里直接附带 Alpine Linux 二进制

怎么运行#

这个项目当前主要面向 Alpine Linux 部署。

最快方式是一键安装，直接执行：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/Assute/website-proxy/main/install.sh | sh

如果你要强制覆盖已有 config.json：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/Assute/website-proxy/main/install.sh | OVERWRITE_CONFIG=1 sh

一键脚本会自动下载程序、安装 OpenRC 服务、设置开机自启并立即启动。

如果你想手动安装，可以继续按下面步骤执行。

仓库里已经包含：

website-proxy 二进制
website-proxy.initd
config.json

把这些文件放到服务器后，执行下面这几步就能跑起来：

Terminal window

1
mkdir -p /opt/website-proxy
2
chmod +x /opt/website-proxy/website-proxy
3
cp /opt/website-proxy/website-proxy.initd /etc/init.d/website-proxy
4
chmod +x /etc/init.d/website-proxy
5
rm -f /run/website-proxy.pid
6
rc-update add website-proxy default
7
rc-service website-proxy start
8
rc-service website-proxy status
9
tail -n 50 /var/log/website-proxy.log

默认访问入口：

1
http://your-server:16800/go

配置文件默认放在：

1
/opt/website-proxy/config.json

示例配置：

1
{
2
  "target_url": "https://example.com",
3
  "allowed_host_suffixes": [
4
    "example.com"
5
  ],
6
  "port": 16800,
7
  "upstream_proxy_on": false,
8
  "upstream_proxy_url": "",
9
  "access_log": false
10
}

如果只是更新程序，可以替换新的二进制后再重启：

Terminal window

1
rc-service website-proxy stop || true
2
rm -f /run/website-proxy.pid
3
chmod +x /opt/website-proxy/website-proxy
4
rc-service website-proxy start

为什么选择 Go#

这个项目选 Go，主要还是因为这几个原因：

单文件二进制部署方便
处理 HTTP 服务很稳
性能和资源占用比较平衡
后续扩展缓存、重写逻辑、配置加载都比较顺手

对于这种偏实用型的小服务，Go 很合适。

项目地址#

GitHub: https://github.com/Assute/website-proxy

如果你也在做类似的网站中转、统一入口或者中转加速场景，这个项目应该能提供一点参考。

企业微信自建应用通知教程：把应用管理做成消息渠道

Mon, 16 Mar 2026 13:27:17 GMT

最近在整理通知渠道的时候，顺手把 企业微信自建应用 这条路也捋了一遍。

如果你的目标是：

做一个系统通知渠道
让程序把告警、状态、结果推送到企业微信
不想走个人微信那种不稳定方案

那最稳的一条路线，其实就是：

企业微信管理后台 → 应用管理 → 自建应用 → 用应用消息做通知。

这篇就按这个方向来写，尽量直白一点，直接说怎么配、怎么发。

首页图片#

企业微信自建应用通知教程首页图

一、先说它适合做什么#

企业微信自建应用，最适合拿来做这类通知：

服务器运行结果通知
定时任务成功 / 失败提醒
域名、证书、监控告警
面板后台消息推送
订单、工单、审批类内部通知

它的好处是比较稳定，因为本质上走的是企业微信官方应用消息接口，不是靠网页硬跳某个个人号。

二、后台入口在哪里#

先登录企业微信管理后台：

企业微信后台：https://work.weixin.qq.com/

然后按下面路径进入：

1
应用管理 → 自建 → 创建应用

创建时一般会让你填写：

应用名称
应用 Logo
可见范围

这里有一个很关键的点：

你后面要接收通知的人，必须在这个应用的可见范围里。

否则程序消息是发不进去的。

三、创建完以后要记住哪几个值#

创建好自建应用后，后面最常用的是这 3 个：

CorpID：企业 ID
AgentID：应用 ID
Secret：这个自建应用自己的密钥

这 3 个里最容易拿错的是 Secret。

注意：

不是随便拿一个企业级密钥
不是通讯录同步 secret
必须是这个自建应用自己的 Secret

四、接收通知的人怎么确定#

程序发消息时，通常还需要一个接收人标识，也就是：

UserID

这里不要直接写成员姓名。

要用的是企业微信成员对应的 UserID。
如果你不确定，可以在通讯录里查看成员详情，或者通过接口读取成员信息。

官方成员读取文档：

读取成员：https://work.weixin.qq.com/api/doc/90000/90135/90196

五、程序发送通知的基本流程#

整个流程其实很简单，就两步：

第一步：获取 `access_token`#

官方文档：

获取 access_token：https://work.weixin.qq.com/api/doc/90000/90135/91039

请求地址：

1
GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的CorpID&corpsecret=你的Secret

拿到成功响应后，会返回一个 access_token。

第二步：发送应用消息#

官方文档：

发送应用消息：https://work.weixin.qq.com/api/doc/90000/90135/90236

请求地址：

1
POST https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

最简单的文本消息体可以写成这样：

1
{
2
  "touser": "zhangsan",
3
  "msgtype": "text",
4
  "agentid": 1000002,
5
  "text": {
6
    "content": "这是一条测试通知"
7
  },
8
  "safe": 0
9
}

六、用 `curl` 测试一遍#

如果你想最快确认通不通，先直接用 curl。

1）获取 token#

Terminal window

1
curl "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的CorpID&corpsecret=你的Secret"

正常会返回类似：

1
{
2
  "errcode": 0,
3
  "errmsg": "ok",
4
  "access_token": "xxxxx",
5
  "expires_in": 7200
6
}

2）发送测试消息#

Terminal window

1
curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=你的ACCESS_TOKEN" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
    "touser": "zhangsan",
5
    "msgtype": "text",
6
    "agentid": 1000002,
7
    "text": {
8
      "content": "企业微信通知测试成功"
9
    },
10
    "safe": 0
11
  }'

如果返回：

1
{
2
  "errcode": 0,
3
  "errmsg": "ok"
4
}

那就说明这条通知链路已经通了。

七、Node.js 示例#

如果你是自己写后台，下面这个 Node.js 示例基本就够用了。

1
const axios = require("axios");
2

3
async function sendWecomText() {
4
  const corpId = "你的CorpID";
5
  const secret = "你的Secret";
6
  const agentId = 1000002;
7
  const toUser = "zhangsan";
8

9
  const tokenResp = await axios.get(
10
    "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
11
    {
12
      params: {
13
        corpid: corpId,
14
        corpsecret: secret,
15
      },
16
    }
17
  );
18

19
  const accessToken = tokenResp.data.access_token;
20

21
  const sendResp = await axios.post(
22
    `https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${accessToken}`,
23
    {
24
      touser: toUser,
25
      msgtype: "text",
26
      agentid: agentId,
27
      text: {
28
        content: "这是一条来自自建应用的通知",
29
      },
30
      safe: 0,
31
    }
32
  );
33

34
  console.log(sendResp.data);
35
}
36

37
sendWecomText().catch(console.error);

显示更多显示更少

八、做成“通知渠道”时怎么理解#

如果你是在做自己的项目后台，其实可以把企业微信自建应用理解成一个标准通知渠道：

配置区保存 CorpID
配置区保存 AgentID
配置区保存 Secret
配置区保存默认接收人 UserID
发送通知时先获取 token，再发消息

也就是说，它和邮箱通知、Telegram Bot 通知、本质上是同一类东西：

都是你系统里的一个消息出口。

九、最容易踩坑的地方#

这里我把最常见的问题直接列出来。

1）接收人不在应用可见范围里#

这是最常见的。

应用虽然创建好了，但如果成员不在这个自建应用的可见范围里，消息就是发不过去。

2）把姓名当成 `UserID`#

发送消息时，touser 用的是 UserID，不是成员姓名，也不是昵称。

3）`Secret` 拿错#

一定要用自建应用自己的 Secret。

4）接口通了，但人没看到通知#

先确认：

成员是否已经加入企业
成员是否在应用可见范围
应用是否正常启用
发的是企业微信应用消息，不是普通微信个人消息

5）想发到“普通微信”里#

这里要分清楚：

这篇教程做的是企业微信应用通知
不是直接给普通微信个人号发消息

如果成员已经绑定微信，并开启企业微信相关接收方式，有些场景会在微信插件里收到；
但这条教程本身的目标，仍然是：把企业微信作为通知渠道。

十、适合接到哪些项目里#

如果你手里有这些项目，都很适合直接接企业微信通知：

面板项目
域名监控
备份脚本
定时抓取任务
Docker 容器巡检
证书到期提醒

尤其是内部项目、自己团队用的项目，这种方式会比个人微信方案稳定很多。

官方参考#

企业微信后台：https://work.weixin.qq.com/
企业微信开发者中心：https://developer.work.weixin.qq.com/document
获取 access_token：https://work.weixin.qq.com/api/doc/90000/90135/91039
发送应用消息：https://work.weixin.qq.com/api/doc/90000/90135/90236
读取成员：https://work.weixin.qq.com/api/doc/90000/90135/90196

CF-dns：Cloudflare DNS 多域名管理面板

Mon, 16 Mar 2026 13:05:23 GMT

最近整理了一个自己在用的项目：CF-dns。

它不是单纯查 DNS 记录的小工具，而是一个更偏实用方向的 Cloudflare DNS 多域名管理面板。
核心目标很直接：把 Cloudflare 域名、DNS 记录和证书管理这几件高频操作，集中到一个界面里完成。

页面效果#

登录界面#

CF-dns 登录界面

首页#

CF-dns 首页

添加域名#

CF-dns 添加域名

域名管理#

CF-dns 域名管理

这个项目具体做什么？#

CF-dns 主要解决的是 Cloudflare 多域名管理时比较碎、比较重复的问题。

平时最常见的几类操作基本都集中到了面板里：

添加并管理多个 Cloudflare 域名
查看、添加、编辑、删除 DNS 记录
批量修改解析记录的 IP 和代理状态
批量删除无用记录
一键申请和撤销 Cloudflare Origin 证书
下载证书和私钥文件
支持拖拽排序域名

如果域名一多，纯靠 Cloudflare 后台一个个点，效率其实挺低。
这个项目做的事情，就是把这些操作整理成一个更直接的管理界面。

主要功能#

多域名管理：支持同时管理多个 Cloudflare 域名
Token 校验：添加域名时会直接校验 Token 和 Zone 信息
DNS 记录管理：支持 A、AAAA、CNAME、TXT 等常见记录类型
批量操作：支持批量修改、批量删除、批量证书操作
证书管理：一键申请 Origin Certificate，并支持下载 PEM / KEY
登录认证：带独立登录页，支持修改用户名和密码
域名排序：支持拖拽调整域名顺序
移动端适配：手机和平板也能正常使用

技术栈#

这个项目整体比较直接，没有走很重的前端框架路线，而是偏实用型组合：

Node.js + Express：服务端和接口路由
express-session：登录态和会话管理
Axios：请求 Cloudflare API
node-forge：生成私钥、CSR 和证书相关内容
原生 JavaScript + CSS：前端界面
Docker / Docker Compose：部署方式

运行方式#

一键安装#

国内服务器：

Terminal window

1
bash <(curl -fsSL https://gitee.com/Assute/CF-dns/raw/master/install.sh)

国外服务器：

Terminal window

1
bash <(curl -fsSL https://raw.githubusercontent.com/Assute/CF-dns/main/install.sh)

安装完成后访问：

1
http://你的服务器IP:3600

默认登录信息：

1
用户名：admin
2
密码：admin123

第一次登录后建议立即修改密码。

使用前准备#

在添加域名前，需要先准备好 Cloudflare API Token。

这个项目用到的核心权限主要是：

Zone - DNS - Edit
Zone - SSL and Certificates - Edit

面板里本身已经做了教程入口，登录后可以直接查看图文说明。

服务管理常用命令#

如果是默认方式安装，常用命令基本就是下面这些：

Terminal window

1
# 查看日志
2
docker-compose -f /opt/CF-dns/docker-compose.yml logs -f
3

4
# 重启服务
5
docker-compose -f /opt/CF-dns/docker-compose.yml restart
6

7
# 停止服务
8
docker-compose -f /opt/CF-dns/docker-compose.yml down
9

10
# 查看容器状态
11
docker ps | grep cf-cdn-manager

如果你想彻底卸载：

Terminal window

1
docker-compose -f /opt/CF-dns/docker-compose.yml down
2
sudo rm -rf /opt/CF-dns

这个项目的几个实际价值#

我自己做它，主要不是为了“做一个好看后台”，而是因为 Cloudflare 相关操作确实容易碎。

尤其是下面这些场景，会明显更省事：

手里有多个域名，需要频繁切换管理
经常改解析记录和代理开关
要批量申请证书
想在手机上也能随时处理域名解析

这些事情如果都回到 Cloudflare 原站后台去做，能做是能做，但不够顺手。
CF-dns 更像是把这些高频动作重新收成了一个更适合自己使用习惯的面板。

项目结构#

1
CF-dns/
2
├─ public/
3
│  ├─ login.html
4
│  ├─ index.html
5
│  ├─ tutorial.html
6
│  ├─ app.js
7
│  └─ styles.css
8
├─ data/
9
├─ server.js
10
├─ package.json
11
├─ Dockerfile
12
├─ docker-compose.yml
13
├─ install.sh
14
└─ README.md

总结#

如果你本身就在用 Cloudflare，而且手里不止一个域名，那这种管理面板会比原始后台更适合日常高频操作。

CF-dns 现在的方向也很明确：

用简单直接的方式管理 Cloudflare 域名
保留一键安装能力
用最少的依赖完成核心功能
让桌面端和手机端都能正常使用

后面如果还继续补功能，我大概率也还是会围绕这条路线走：
多域名、高频操作、部署简单、界面直给。

仓库地址#

GitHub：https://github.com/Assute/CF-dns
Gitee：https://gitee.com/Assute/CF-dns

ClawPanel 使用教程：给 OpenClaw 装上可视化管理面板

Mon, 16 Mar 2026 12:18:12 GMT

ClawPanel 官方界面截图

如果你已经在用 OpenClaw，或者准备开始折腾 OpenClaw，那么 ClawPanel 这个工具基本值得直接装上。

它本质上是一个给 OpenClaw 准备的可视化管理面板，可以把很多原本要靠命令行完成的事情，整理成更顺手的界面操作。

这篇不写泛泛介绍，直接按教程来整理：

怎么安装
怎么部署
第一次打开后该做什么
常见问题怎么处理

一、ClawPanel 是什么#

简单说，它就是一个 OpenClaw 的管理面板。

它能做的事情主要有这些：

查看服务状态
启动、停止、重启 Gateway
配置模型服务商
管理 Agent 和记忆文件
查看日志
做基础诊断和排障
在面板里直接聊天和测试

如果你觉得纯命令行管理 OpenClaw 有点碎，那这个面板确实能省不少事。

二、先选安装方式#

先说结论，不同场景直接选不同方式：

Windows / macOS 本地使用：直接下载桌面版安装包
Linux 服务器 / NAS / 无桌面环境：用 Web 版
已经有 Docker 环境：用 Docker 或 Compose

如果你只是自己电脑上用，我建议优先桌面版。
如果你要远程管理服务器上的 OpenClaw，我建议直接用 Linux Web 版。

三、桌面端安装方法#

这一种最简单，适合大多数普通用户。

1）打开下载页#

下载地址：

官网：https://claw.qt.cool/
Releases：https://github.com/qingchencloud/clawpanel/releases/latest

根据自己的系统选择安装包：

Windows：优先下载 exe 安装器
macOS：按芯片选择 Apple Silicon 或 Intel 版本
Linux：如果你是桌面 Linux，优先看官方发布包；如果是服务器场景，建议直接用后面的 Web 版教程

2）安装后直接打开#

首次打开时，ClawPanel 会自动带你做基础检查，比如：

Node.js 是否可用
Git 是否可用
OpenClaw 是否已安装
当前环境是否能启动 Gateway

3）macOS 提示“已损坏”或“无法验证开发者”怎么办#

官方给出的处理方式是：

Terminal window

1
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

如果你还没把应用拖进“应用程序”目录，就先拖进去再执行。

四、Linux Web 版部署教程#

如果你是云服务器、NAS、HomeLab，或者本来就没有桌面环境，这一套更适合。

环境要求#

Node.js 18+，推荐 22 LTS
npm
Git
已安装的 OpenClaw

方式一：一键部署#

这是官方最省事的方式：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

这个脚本会自动完成：

检测系统
安装 Node.js（如果缺少）
安装 OpenClaw（如果缺少）
克隆 ClawPanel 仓库
安装依赖
创建服务并启动

部署完成后，直接访问：

1
http://服务器IP:1420

方式二：手动部署#

如果你想自己掌控每一步，可以按官方文档手动部署。

1）安装 Node.js#

Ubuntu / Debian：

Terminal window

1
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
2
sudo apt-get install -y nodejs

验证：

Terminal window

1
node -v
2
npm -v

2）安装 OpenClaw#

Terminal window

1
npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com
2
openclaw init

3）克隆并安装 ClawPanel#

Terminal window

1
cd /opt
2
sudo git clone https://github.com/qingchencloud/clawpanel.git
3
sudo chown -R $(whoami) clawpanel
4
cd clawpanel
5
npm install

4）构建并启动 Web 面板#

Terminal window

1
npm run build
2
npm run serve

默认监听：

1
0.0.0.0:1420

如果你想换端口：

Terminal window

1
npm run serve -- --port 8080

五、Docker 部署教程#

如果你机器上已经有 Docker，这种方式也很直接。

快速启动#

Terminal window

1
docker run -d \
2
  --name clawpanel \
3
  --restart unless-stopped \
4
  -p 1420:1420 \
5
  -v clawpanel-data:/root/.openclaw \
6
  node:22-slim \
7
  sh -c "\
8
    apt-get update && apt-get install -y git && \
9
    npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \
10
    openclaw init 2>/dev/null || true && \
11
    git clone https://github.com/qingchencloud/clawpanel.git /app && \
12
    cd /app && npm install && npm run build && \
13
    npm run serve"

启动后访问：

1
http://服务器IP:1420

Docker 方式要注意的点#

数据目录要持久化到 /root/.openclaw
快速启动适合体验，不太适合长期生产使用
如果你准备长期跑，官方更推荐 Compose 或自定义镜像方案
如果要让面板去管理 Gateway，Docker 场景下要考虑网络和进程管理方式

六、第一次打开后怎么配置#

这一步其实最重要。

建议你按下面顺序来：

1）先检查环境#

先确认面板里这些项目都是正常的：

Node.js
Git
OpenClaw
Gateway 状态

如果这里有红色报错，先不要急着继续配模型，先把基础环境处理好。

2）配置模型服务商#

进入模型配置页后，至少先添加一个可用模型。

比如常见的：

DeepSeek
OpenAI
阿里通义
Ollama

填好 Base URL 和 API Key 之后，先做一次连接测试，确认能通再保存。

3）启动 Gateway#

进入服务管理页面，启动 Gateway。
如果状态能正常变绿，说明核心服务已经跑起来了。

4）去聊天页做一次测试#

这一步不要省。

直接去实时聊天页面，发一句简单测试，例如：

1
你好，请回复一句“连接正常”

如果能稳定返回，就说明这套流程已经打通了。

七、常见问题#

1）提示 `openclaw.json` 不存在#

说明 OpenClaw 还没有初始化。

执行：

Terminal window

1
openclaw init

2）1420 端口被占用#

可以先看是谁占用了端口：

Terminal window

1
lsof -i :1420

如果不想处理占用，也可以直接换端口：

Terminal window

1
npm run serve -- --port 3000

3）反向代理后页面打不开或聊天不通#

这种情况通常是 WebSocket 没配好。

如果你用 Nginx 反代，记得加上：

Upgrade
Connection "upgrade"

否则面板和 Gateway 的 WebSocket 通信可能会失败。

4）从外网访问不到#

重点检查这几项：

服务器防火墙
云服务器安全组
端口 1420
如果 Gateway 也要外部访问，再看 18789

八、我更推荐哪种方式#

如果你问我怎么选，我会这样建议：

本地自己用：桌面版
远程服务器长期跑：Linux Web 版
已经是 Docker 环境：Docker / Compose

如果你只是想最快体验，桌面版最省事。
如果你准备长期管理 OpenClaw，Linux Web 版会更像一个长期方案。

生意参谋搜索词深度分析工具：批量读取 Excel 关键词并自动导出相关搜索词指标

Sat, 07 Mar 2026 08:06:01 GMT

做电商选词和测词时，很多人都会用到生意参谋里的搜索分析功能。

问题在于：单个词手动查不难，词一多就很累。

尤其是当你已经整理好一批种子词，想逐个查看相关搜索词、搜索人气、支付买家数、需求供给比这些指标时，手动复制、翻页、导出，效率会非常低。

所以我把这款工具也单独整理成一篇文章。它更适合的场景不是“按类目漫游采集”，而是：你已经有一批关键词，想让软件按 Excel 批量跑完整个搜索分析流程。

软件是做什么的？#

这款工具本质上是一套 生意参谋搜索词深度分析自动化助手。

从代码逻辑来看，它主要完成下面几件事：

连接本地 Chrome 调试端口
打开并读取 Excel 关键词表
逐行取出待分析的搜索词
自动进入生意参谋搜索分析页面
抓取相关搜索词及核心指标
把结果持续写回 Excel
任务完成或异常时发送企业微信通知

也就是说，它更像一个“关键词批处理执行器”，而不是一个简单的单次查询工具。

软件界面#

这是这款软件的界面截图：

生意参谋搜索词深度分析工具界面

从界面和源码逻辑可以看出，它把常用操作都集中到一个窗口里了：

浏览器路径
调试端口
Excel 文件路径
查询日期
搜索间隔
翻页间隔
日志输出
Token 保存 / 登录
启动浏览器 / 启动 Excel / 开始任务

整体思路比较直接，适合桌面端长期跑批量任务。

这款工具有哪些功能？#

结合你给出的源码，我整理出它的核心能力大概有这些：

1）批量读取 Excel 关键词#

程序会从 Excel 里按行读取关键词，并逐行执行搜索分析。

从代码逻辑看：

第 1 个工作表用来放待处理关键词
A 列是搜索词
F 列作为“是否已搜索”的完成标记

也就是说，只要你把关键词先整理到表里，它就能按行自动跑。

2）自动进入生意参谋搜索分析页#

工具会自动拼接搜索分析页面地址，并带上日期参数，直接打开对应关键词的分析页面。

代码里默认把查询日期设置成“昨天”，这一点很适合日常运营分析。打开软件后，日期会自动填成前一天，不用每次手改。

3）自动抓取核心指标#

从抓取逻辑来看，它会提取并保存以下几类数据：

相关搜索词
搜索人气
支付转化率
支付买家数
需求供给比
天猫商品点击占比

这些都是做搜索词判断时非常常用的指标。

4）结果自动写回 Excel#

抓到数据以后，程序会把结果写入第 2 个工作表。

从代码里可以看出，第二个工作表大致会按下面结构输出：

A 列：相关搜索词
B 列：搜索人气
C 列：支付转化率
D 列：支付买家数
E 列：需求供给比
F 列：天猫商品点击占比

这样做的好处是：

原始关键词和结果分开
后续筛选、排序、透视更方便
跑完就能直接继续做分析

5）支持翻页采集#

很多关键词的相关搜索词不只一页。

这套工具会在页面里继续点“下一页”，把后续结果也抓下来，而不是只拿首页数据。对于想做更完整关键词池的人来说，这点很实用。

6）支持风险控制后的延迟重试#

源码里专门写了滑块检测逻辑。

也就是说，如果页面出现风控验证，程序不会直接崩掉，而是会：

记录日志
暂停当前关键词处理
延时后再重试当前词

这个设计的意义很大，因为批量任务最怕的就是跑到一半中断。

7）支持 Cookie 保存与恢复登录#

工具里还有两个很实用的小功能：

保存当前登录 Cookie
读取本地 Cookie 重新登录

对于经常跑批量任务的人来说，这能省掉一部分重复登录操作。

8）支持企业微信通知#

从源码里还可以看到，它支持企业微信消息推送。

这意味着：

任务跑完可以通知你
出现异常时也可以提醒你

如果你经常把任务挂着跑，这个功能就很实用，不需要一直盯着电脑看。

总结#

如果说前一类工具更偏向“批量采集类目关键词”，那这款软件更偏向“批量跑搜索词深度分析”。

它的核心优势在于：

直接读取现成关键词表
自动进入分析页
自动翻页抓取指标
自动写回 Excel
支持登录状态复用和消息提醒

对于经常做关键词分析、竞品词筛选、相关词池沉淀的人来说，这类工具确实能省掉很多重复操作。

如果后面你还想继续把这个工具完善下去，我觉得最值得继续打磨的方向有三个：

增加更多指标列的自定义开关
增加任务失败重跑记录
增加结果去重和筛选导出能力

这样它会更像一个完整的运营分析工作台，而不只是一个批量执行小工具。

OpenClaw 汉化版 Docker 部署教程

Sat, 07 Mar 2026 08:03:54 GMT

OpenClaw 汉化版官方截图

一、一键 Docker 部署#

如果你想最快部署起来，官方 DOCKER_GUIDE.md 最推荐的方式就是直接运行一键脚本。

Linux / macOS#

Terminal window

1
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash

Windows PowerShell#

Terminal window

1
irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex

官方文档说明，这个脚本会自动完成：

初始化配置
配置远程访问参数
启动容器

如果你不想交给脚本自动处理，可以继续看下面的手动部署方式。

二、镜像地址怎么选#

官方 Docker 指南给了两个镜像源：

1186258278/openclaw-zh：国内用户推荐，Docker Hub 拉取更方便
ghcr.io/1186258278/openclaw-zh：海外用户或默认地址

官方文档里的命令默认使用：

Terminal window

1
ghcr.io/1186258278/openclaw-zh:latest

如果你在国内，只需要把它替换成：

Terminal window

1
1186258278/openclaw-zh:latest

三、本地快速启动#

这一段适合你在本机运行，并通过 localhost 访问 Dashboard。

Terminal window显示更多显示更少

1
# 海外: ghcr.io/1186258278/openclaw-zh:latest
2
# 国内: 1186258278/openclaw-zh:latest
3
IMAGE=ghcr.io/1186258278/openclaw-zh:latest
4

5
# 1. 初始化配置（首次运行，需要交互式配置 AI 模型和 API 密钥）
6
docker run --rm -it -v openclaw-data:/root/.openclaw \
7
  $IMAGE openclaw onboard
8

9
# 2. 配置网关模式（本地访问）
10
docker run --rm -v openclaw-data:/root/.openclaw \
11
  $IMAGE openclaw config set gateway.mode local
12

13
# 3. 启动容器（守护进程模式）
14
docker run -d \
15
  --name openclaw \
16
  -p 18789:18789 \
17
  -v openclaw-data:/root/.openclaw \
18
  --restart unless-stopped \
19
  $IMAGE \
20
  openclaw gateway run

显示更多显示更少

启动后访问：

1
http://localhost:18789

这组参数里最关键的是：

-v openclaw-data:/root/.openclaw：把配置持久化到 Docker 数据卷
-p 18789:18789：把网关端口映射出来
--restart unless-stopped：除非你手动停掉，否则容器会自动保持运行

四、服务器远程部署#

如果你准备部署到 VPS 或其他服务器，并且要从别的设备访问，就要按官方 Docker 指南多配置几步。

Terminal window显示更多显示更少

1
# 海外: ghcr.io/1186258278/openclaw-zh:latest
2
# 国内: 1186258278/openclaw-zh:latest
3
IMAGE=ghcr.io/1186258278/openclaw-zh:latest
4

5
# 1. 创建数据卷
6
docker volume create openclaw-data
7

8
# 2. 初始化配置（首次运行）
9
docker run --rm -it -v openclaw-data:/root/.openclaw \
10
  $IMAGE openclaw onboard
11

12
# 3. 配置远程访问参数
13
docker run --rm -v openclaw-data:/root/.openclaw \
14
  $IMAGE openclaw config set gateway.mode local
15

16
docker run --rm -v openclaw-data:/root/.openclaw \
17
  $IMAGE openclaw config set gateway.bind lan
18

19
# 4. 设置访问令牌（推荐）
20
docker run --rm -v openclaw-data:/root/.openclaw \
21
  $IMAGE openclaw config set gateway.auth.token your-secure-token
22

23
# 5. 启动容器
24
docker run -d \
25
  --name openclaw \
26
  -p 18789:18789 \
27
  -v openclaw-data:/root/.openclaw \
28
  --restart unless-stopped \
29
  $IMAGE \
30
  openclaw gateway run

显示更多显示更少

部署完成后访问：

1
http://服务器IP:18789

然后在 Dashboard 里输入你设置的：

1
your-secure-token

五、远程访问与 Token 认证#

这是官方 Docker 指南里专门强调的一点。

如果你通过 HTTP 从非 localhost 访问，浏览器会阻止设备身份验证，因为 Web Crypto API 需要更安全的上下文环境。

官方给出的最推荐解决方案就是：设置 Token 认证。

如果你容器已经跑起来了，也可以后补：

Terminal window

1
docker exec openclaw openclaw config set gateway.auth.token YOUR_TOKEN
2
docker restart openclaw

然后在浏览器访问：

1
http://服务器IP:18789/overview

在「网关令牌」输入框里填入：

1
YOUR_TOKEN

官方文档里还列了几种替代方案：

Token 认证：最简单，适合内网和普通远程访问
SSH 端口转发：更安全
Tailscale Serve：适合跨网络访问
Nginx + HTTPS：适合生产环境

六、Nginx + HTTPS 反向代理#

如果你准备用 Nginx 做反代，官方 Docker 指南特别提醒：要先配 gateway.trustedProxies，否则可能报：

1
Proxy headers detected from untrusted address

Docker 环境下的官方命令：

Terminal window

1
docker exec openclaw openclaw config set gateway.trustedProxies '["127.0.0.1", "::1"]'
2
docker restart openclaw

如果 Nginx 和 OpenClaw 不在同一台机器上，就把上面的 127.0.0.1 替换成 Nginx 服务器的真实 IP。

七、Docker Compose 部署#

官方项目已经提供了现成的 docker-compose.yml。

Terminal window

1
# 下载配置文件
2
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-compose.yml -o docker-compose.yml
3

4
# 启动（首次会自动初始化）
5
docker-compose up -d

如果你想手动写，也可以按官方 Docker 指南里的结构来：

1
version: '3.8'
2
services:
3
  openclaw:
4
    image: ghcr.io/1186258278/openclaw-zh:latest
5
    container_name: openclaw
6
    ports:
7
      - "18789:18789"
8
    volumes:
9
      - openclaw-data:/root/.openclaw
10
    environment:
11
      - OPENCLAW_GATEWAY_TOKEN=your-secure-token
12
    restart: unless-stopped
13

14
volumes:
15
  openclaw-data:

显示更多显示更少

如果你在国内，可以把镜像换成：

1
1186258278/openclaw-zh:latest

八、常用 Docker 命令#

部署完成后，这些命令最常用：

Terminal window显示更多显示更少

1
# 查看日志
2
docker logs -f openclaw
3

4
# 停止 / 启动 / 重启
5
docker stop openclaw
6
docker start openclaw
7
docker restart openclaw
8

9
# 进入容器
10
docker exec -it openclaw sh
11

12
# 查看 OpenClaw 状态
13
docker exec openclaw openclaw status
14

15
# 在容器里查看帮助
16
docker exec openclaw openclaw --help

显示更多显示更少

如果你修改了网关配置，最常见的操作就是：

Terminal window

1
docker restart openclaw

九、更新 Docker 镜像#

官方 Docker 指南给出的升级方法就是：拉新镜像、删旧容器、重新启动。

Terminal window显示更多显示更少

1
# 海外: ghcr.io/1186258278/openclaw-zh:latest
2
# 国内: 1186258278/openclaw-zh:latest
3
IMAGE=ghcr.io/1186258278/openclaw-zh:latest
4

5
# 1. 拉取最新镜像
6
docker pull $IMAGE
7

8
# 2. 停止并删除旧容器
9
docker stop openclaw && docker rm openclaw
10

11
# 3. 用新镜像重新启动
12
docker run -d --name openclaw -p 18789:18789 \
13
  -v openclaw-data:/root/.openclaw \
14
  --restart unless-stopped \
15
  $IMAGE \
16
  openclaw gateway run

显示更多显示更少

因为配置保存在 openclaw-data 这个数据卷里，所以升级镜像时你的原配置不会丢。

十、常见错误排查#

1）容器能启动，但网页打不开#

优先检查这几项：

docker ps 里有没有 openclaw
端口 18789 有没有映射出来
服务器防火墙或安全组有没有放行 18789

可以先执行：

Terminal window

1
docker ps
2
docker logs -f openclaw

2）远程访问一直连不上#

按官方 Docker 指南，优先检查是不是没设置 Token：

Terminal window

1
docker exec openclaw openclaw config set gateway.auth.token YOUR_TOKEN
2
docker restart openclaw

3）Nginx 反代后报代理不可信#

按官方文档补上：

Terminal window

1
docker exec openclaw openclaw config set gateway.trustedProxies '["127.0.0.1", "::1"]'
2
docker restart openclaw

官方来源#

官方仓库：https://github.com/1186258278/OpenClawChineseTranslation
官方 Docker 部署指南：https://github.com/1186258278/OpenClawChineseTranslation/blob/main/docs/DOCKER_GUIDE.md
官方 README：https://github.com/1186258278/OpenClawChineseTranslation/blob/main/README.md

如果后续镜像地址、端口、部署命令有变化，以官方仓库里的最新 Docker 文档为准。

OpenClaw 汉化版 npm 安装、卸载与升级教程

Sat, 07 Mar 2026 07:45:00 GMT

OpenClaw 汉化版官方截图

一、安装 Node.js#

根据官方安装指南，OpenClaw 要求：

1
Node.js >= 22.12.0

如果你还没有安装 Node.js，可以按你的系统选择下面一种方式。

Windows#

访问 Node.js 官网下载页面下载 LTS 版本安装包并安装。

Node.js下载

Ubuntu / Debian#

Terminal window

1
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
2
sudo apt-get install -y nodejs

CentOS / RHEL#

Terminal window

1
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
2
sudo yum install -y nodejs

安装完成后检查版本#

Terminal window

1
node -v
2
npm -v

二、安装 OpenClaw 汉化版#

官方 npm 安装命令：

Terminal window

1
npm install -g @qingchencloud/openclaw-zh@latest

如果你在国内下载慢，可以直接使用官方文档里的镜像源：

Terminal window

1
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

npm安装

三、初始化配置（图文详解）#

运行初始化命令：

Terminal window

1
openclaw onboard --install-daemon

按照界面提示依次完成以下步骤：

初始化配置选择 yes

初始化配置选择yes

选择快速开始

选择快速开始

选择模型提供商（自建选择自定义）

选择模型提供商

输入 URL、选择密钥、输入令牌回车

输入URL、选择密钥、输入令牌

再回车，输入模型名称（如 gpt-5.4）回车

输入模型名称

直接回车两次

直接回车两次

四、配置 Telegram 机器人（可选）#

如果想通过 Telegram 使用 OpenClaw，需要先创建机器人。

选择渠道（以 Telegram 为例）

选择渠道

在 Telegram 中搜索 @BotFather

搜索BotFather

对话输入 /newbot，输入机器人名称，再输入机器人用户名，得到 token

创建机器人

回到电脑终端，输入 Telegram 机器人的 token

输入token

五、完成配置#

技能先不配置，选择 no

技能配置

Hooks 全部点击空格勾选，然后回车

启用Hooks

安装成功

安装成功

六、启动与访问#

启动 OpenClaw

Terminal window

1
openclaw gateway

启动Openclaw

打开 Dashboard 控制台

Terminal window

1
openclaw dashboard

或手动访问 http://localhost:18789

Web界面

七、修复无法打开浏览器问题#

如果 OpenClaw 无法打开浏览器，需要修改配置文件。

找到配置文件

路径：C:\Users\用户名\.openclaw\openclaw.json

修改 profile 为 full

找到 tools 部分，将 profile 改为 full：

1
"tools": {
2
    "profile": "full",
3
    "web": {
4
      "search": {
5
        "enabled": true
6
      },
7
      "fetch": {
8
        "enabled": true
9
      }
10
    }
11
  },

修复配置

修改完成后重启 OpenClaw 服务即可。

补充：Telegram 渠道提权配置#

如果你希望在 Telegram 渠道里允许指定账号使用提权能力，可以继续在 openclaw.json 的 tools 配置里补充下面这段：

1
"tools": {
2
    "profile": "full",
3
    "web": {
4
      "search": {
5
        "provider": "brave"
6
      }
7
    },
8
    "elevated": {
9
      "enabled": true,
10
      "allowFrom": {
11
        "telegram": [
12
          "123456789"
13
        ]
14
      }
15
    }
16
  },

显示更多显示更少

说明：

provider: "brave"：把搜索提供商设置为 brave
enabled: true：开启提权能力
allowFrom.telegram：只允许这里填写的 Telegram 用户 ID 使用提权
123456789：记得替换成你自己的 Telegram 数字 ID

修改完成后同样需要重启 OpenClaw 服务。

八、常用管理命令#

Terminal window显示更多显示更少

1
# 查看状态和诊断
2
openclaw status
3
openclaw doctor
4

5
# 重启服务
6
openclaw gateway restart
7

8
# 守护进程管理
9
openclaw daemon start
10
openclaw daemon stop
11
openclaw daemon restart
12
openclaw daemon status
13

14
# 其他常用命令
15
openclaw dashboard          # 打开网页控制台
16
openclaw config             # 查看/修改配置
17
openclaw skills             # 管理技能
18
openclaw --help             # 查看帮助

显示更多显示更少

九、卸载教程#

卸载 CLI：

Terminal window

1
npm uninstall -g @qingchencloud/openclaw-zh

删除配置（可选，不可恢复）：

Terminal window

1
rm -rf ~/.openclaw

卸载守护进程：

macOS

Terminal window

1
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
2
rm ~/Library/LaunchAgents/com.openclaw.plist

Linux

Terminal window

1
sudo systemctl stop openclaw
2
sudo systemctl disable openclaw
3
sudo rm /etc/systemd/system/openclaw.service
4
sudo systemctl daemon-reload

十、更新升级#

升级到最新版：

Terminal window

1
npm update -g @qingchencloud/openclaw-zh

或使用 CLI 检查更新：

Terminal window

1
openclaw update

官方来源#

官方仓库：https://github.com/1186258278/OpenClawChineseTranslation
官方安装指南：https://github.com/1186258278/OpenClawChineseTranslation/blob/main/docs/INSTALL_GUIDE.md
官方 README：https://github.com/1186258278/OpenClawChineseTranslation/blob/main/README.md

如果后续命令有变化，以官方仓库里的最新文档为准。

CLI Proxy API VPS 一键安装与 GUI 启用指南（非 Docker）

Sat, 07 Mar 2026 06:45:00 GMT

一、在 VPS 上一键安装 CLI Proxy API#

先通过 SSH 登录你的 Linux VPS，然后直接执行官方推荐的一键安装命令：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

安装完成后，先检查服务状态：

Terminal window

1
systemctl --user status cli-proxy-api

如果你希望它开机自动启动，再执行：

Terminal window

1
systemctl --user enable cli-proxy-api

二、打开配置文件#

默认配置文件一般在：

Terminal window

1
~/.cli-proxy-api/config.yaml

直接编辑它：

Terminal window

1
nano ~/.cli-proxy-api/config.yaml

如果你习惯用 vi，也可以这样：

Terminal window

1
vi ~/.cli-proxy-api/config.yaml

三、修改 config.yaml 启用 GUI#

把配置文件改成类似下面这样，重点是 remote-management 这一段：

1
port: 8317
2

3
auth-dir: "~/.cli-proxy-api"
4

5
request-retry: 3
6

7
quota-exceeded:
8
  switch-project: true
9
  switch-preview-model: true
10

11
api-keys:
12
  - "ABC-123456"
13

14
remote-management:
15
  allow-remote: true
16
  secret-key: "MGT-123456"
17
  disable-control-panel: false

显示更多显示更少

这几项的作用分别是：

port: 8317：服务监听端口
api-keys：代理接口使用的访问密钥
remote-management.allow-remote: true：允许远程访问 GUI
remote-management.secret-key：GUI 登录密码
disable-control-panel: false：启用内置控制面板

注意两点：

api-keys 和 remote-management.secret-key 不是同一个东西
如果你的配置文件里已经有这些字段，直接修改原值，不要重复写两份同名配置

四、重启服务让配置生效#

改完配置后，执行重启：

Terminal window

1
systemctl --user restart cli-proxy-api

然后再次确认服务状态：

Terminal window

1
systemctl --user status cli-proxy-api

如果你想实时看日志，可以执行：

Terminal window

1
journalctl --user -u cli-proxy-api -f

五、浏览器访问 GUI#

服务重启完成后，在浏览器打开：

1
http://你的服务器IP:8317/management.html

如果你已经绑定了域名，也可以这样访问：

1
http://你的域名:8317/management.html

打开后输入你在配置文件里设置的管理密码，例如：

1
MGT-123456

这样就可以进入 GUI 管理页面。

六、CLI Proxy API 的 GUI 图片#

下面这张是官方 GUI 界面截图：

CLI Proxy API GUI 界面

如果你是远程 VPS 访问场景，浏览器访问的就是主程序内置的：

1
/management.html

七、补充：CC 配置 GPT-5.4 1M 对话#

如果你已经把 CLI Proxy API 跑起来了，还想在 CC 里开启 GPT-5.4 的大上下文对话，可以把下面这段补到对应配置中：

1
model = "gpt-5.4"
2
model_reasoning_effort = "xhigh"
3
model_context_window = 1047576
4
model_auto_compact_token_limit = 105197
5
web_search = "live"
6

7
[features]
8
multi_agent = true
9

10
[agents]
11
max_threads = 4

这几项可以这样理解：

model = "gpt-5.4"：切换到 GPT-5.4
model_reasoning_effort = "xhigh"：开启更高推理强度
model_context_window = 1047576：把上下文窗口开到接近 1M
model_auto_compact_token_limit = 105197：超过阈值后自动压缩上下文
web_search = "live"：启用实时联网搜索
multi_agent = true：开启多代理能力
max_threads = 4：最多并行 4 个代理线程

如果你本地已经配置好了接口地址和密钥，这一段加进去后，就可以直接用于 GPT-5.4 的长上下文对话场景。

八、常见问题#

1）为什么打开不了管理页面？#

优先检查下面几项：

remote-management.allow-remote 是否为 true
disable-control-panel 是否为 false
服务是否已经重启
VPS 防火墙是否放行 8317 端口
云服务器安全组是否放行 8317 端口

如果你用的是 ufw，可以放行端口：

Terminal window

1
sudo ufw allow 8317/tcp

2）为什么输入密码后进不去？#

检查你输入的是不是：

1
remote-management:
2
  secret-key: "MGT-123456"

这里的 secret-key 是 GUI 登录密码，不是 api-keys 里的接口密钥。

3）为什么改了配置没生效？#

最常见原因就是：改完后没有重启服务。

重新执行一次：

Terminal window

1
systemctl --user restart cli-proxy-api

九、最短操作版#

如果你只想快速完成部署，直接按下面执行：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash
2
nano ~/.cli-proxy-api/config.yaml
3
systemctl --user restart cli-proxy-api

然后浏览器打开：

1
http://你的服务器IP:8317/management.html

输入你设置的：

1
MGT-123456

到这里就完成了：VPS 一键安装 -> 修改配置启用 GUI -> 重启生效 -> 浏览器进入管理页面。

十、参考资料#

官方 GUI 教程：https://help.router-for.me/cn/hands-on/tutorial-6
配置选项文档：https://help.router-for.me/cn/configuration/options
基础配置文档：https://help.router-for.me/cn/configuration/basic
GUI 仓库：https://github.com/router-for-me/Cli-Proxy-API-Management-Center
主程序仓库：https://github.com/router-for-me/CLIProxyAPI

Apple ID 共享平台：基于 Node.js 的实时抓取与展示

Fri, 06 Mar 2026 17:07:45 GMT

最近把这个项目重新整理了一下，它不是通用信息面板，而是一个更明确的场景：Apple ID 共享平台。

核心目标就是一件事： 访问页面时实时抓取最新账号数据，然后直接在页面展示。

页面效果#

Apple ID 共享平台页面效果图

这个项目具体做什么？#

它主要完成下面几步：

从源站拉取最新页面内容
解析出账号、密码、地区、状态、检测时间
过滤不需要的地区（如中国大陆、香港、台湾）
将数据直接嵌入 HTML 返回给前端
前端直接渲染，无需额外再请求 API

这套方式的好处是：页面每次刷新都尽量是最新数据，结构也比较简单直接。

主要功能#

实时抓取：每次访问首页时都会重新抓取数据
账号解析：自动提取邮箱、密码、地区、状态、时间
地区过滤：自动排除指定地区的数据
数据脱敏展示：邮箱在前端展示时做了脱敏处理
广告可配置：通过 config.json 管理多个广告卡片
直接嵌入数据：数据在服务端注入到 HTML 中，前端可直接读取

技术栈#

Node.js + Express：服务端与路由
Axios：请求源站页面
Cheerio：解析 HTML 并提取字段
原生 HTML/CSS/JS：页面展示与交互

项目结构#

1
Apple_id/
2
├─ index.js
3
├─ index.html
4
├─ config.json
5
├─ package.json
6
├─ Dockerfile
7
├─ docker-compose.yml
8
└─ README.md

运行方式#

本地运行#

Terminal window

1
npm install
2
node index.js

默认访问：

1
http://localhost:8000

Docker 运行#

Terminal window

1
docker build -t apple-id .
2
docker run -d -p 8000:8000 --name apple-id apple-id

或：

Terminal window

1
docker-compose up -d

适合场景#

需要把网页账号信息做统一展示
想要轻量、可快速部署的共享页
希望用最少依赖完成抓取 + 展示闭环

项目地址#

GitHub：https://github.com/Assute/Apple_id

如果你也是做这类轻量共享页，这种“实时抓取 + 服务端注入 + 前端直读”的写法会比较省事。

Codex 自动注册与 CPA 自动补号脚本说明

Fri, 06 Mar 2026 17:07:44 GMT

这个脚本主要做两件事：

Codex 自动注册 自动执行注册流程，减少手动重复操作。
CPA 自动补号 当号量不足时自动补充，保持任务连续运行。

运行效果#

脚本运行截图

整体目标就是：提升效率、降低人工干预、让流程更稳定。

被屏蔽海外访问的国内服务器，如何用代理做加速

Fri, 06 Mar 2026 10:55:17 GMT

被屏蔽海外访问的国内服务器，如何用代理做加速#

如果你的国内业务机无法稳定访问 GitHub、Raw 脚本或其他海外资源，更稳妥的做法不是在业务机上硬配代理，而是把访问链路拆成两层：

海外机器部署 DL-Proxy，负责真正访问目标站点
国内机器部署 CN-Proxy，负责把业务流量中继到 DL-Proxy
业务机只访问国内中继，不再直接碰海外地址

这种方式部署简单、链路清晰，也更适合长期维护。

一、整体架构#

1
A（业务机，海外访问受限）
2
  -> B（CN-Proxy，国内中继，端口 9010）
3
  -> C（DL-Proxy，海外上游，端口 9011）
4
  -> GitHub / 任意 HTTPS 目标站点

**A：**你的业务服务器，只访问 B。
**B：**国内中继服务器，运行 CN-Proxy。
**C：**海外服务器，运行 DL-Proxy，负责访问目标站点。

二、部署前准备#

开始前请先确认：

C 服务器可以正常访问海外资源，并且已经安装 Docker
B 服务器具备 root 权限，CN-Proxy 脚本会自动安装并配置 nginx
安全组或防火墙已经放通 B:9010 和 C:9011

注意：DL-Proxy 的安装脚本会构建并启动 Docker 容器，但不会自动安装 Docker。

三、先部署 DL（海外服务器 C）#

登录海外服务器：

Terminal window

1
ssh root@C_IP

执行一键安装脚本：

Terminal window

1
bash <(curl -fsSL https://raw.githubusercontent.com/Assute/dl_proxy/main/dl_proxy.sh)

安装完成后，确认服务已经启动：

Terminal window

1
docker ps --filter "name=dl_proxy"
2
curl -I "http://127.0.0.1:9011/https://github.com"

如果返回正常，说明 DL-Proxy 已经可用。后面部署 CN-Proxy 时，脚本提示你填写的 gh-proxy 地址，实际上就是这里的 DL 服务地址，例如：

1
http://C_IP:9011

DL 部署完成后的示例效果：

DL 部署完成示例

四、再部署 CN（国内服务器 B）#

登录国内服务器：

Terminal window

1
ssh root@B_IP

执行一键安装脚本：

Terminal window

1
bash <(curl -fsSL https://raw.githubusercontent.com/Assute/cn_proxy/main/cn_proxy.sh)

脚本会提示你输入两项内容：

**gh-proxy 地址：**填写上一步部署好的 DL 地址，例如 http://C_IP:9011
**本机监听端口：**直接使用默认的 9010 即可

部署完成后，验证 CN-Proxy 是否正常：

Terminal window

1
nginx -t
2
curl -I "http://127.0.0.1:9010/https://github.com"

CN 部署完成后的示例效果：

CN 部署完成示例

五、业务机 A 的使用方式#

部署完成后，业务机只需要把目标地址拼接到 CN-Proxy 后面：

1
http://B_IP:9010/https://目标地址

常见示例：

Terminal window

1
# 下载压缩包
2
wget "http://B_IP:9010/https://github.com/user/repo/archive/master.zip"
3

4
# 克隆仓库
5
git clone "http://B_IP:9010/https://github.com/user/repo.git"
6

7
# 下载并执行远程脚本
8
bash <(curl -fsSL "http://B_IP:9010/https://raw.githubusercontent.com/user/repo/main/install.sh")
9

10
# 代理访问任意 HTTPS 资源
11
curl "http://B_IP:9010/https://example.com/path/to/file"

CN-Proxy 会对常见脚本和配置文件里的 https:// 链接做替换，因此像 bash <(curl ...) 这类场景通常也能更稳定地跑通。

六、常用运维命令#

DL（C 服务器）

Terminal window

1
docker logs -f dl_proxy
2
docker restart dl_proxy
3
docker stop dl_proxy
4
docker rm -f dl_proxy

CN（B 服务器）

Terminal window

1
nginx -t
2
systemctl restart nginx
3
nginx -s reload

七、常见问题#

1）CN 返回 502
先在 B 服务器上检查能否访问 C：

Terminal window

1
curl -I "http://C_IP:9011/https://github.com"

如果这里不通，优先检查 C:9011 是否放行，以及 dl_proxy 容器是否正常运行。

2）DL 脚本执行失败
优先确认 C 服务器已经安装 Docker，并且 docker build、docker run 可以正常执行。

3）访问超时
检查安全组、防火墙和运营商网络限制，确认 B:9010、C:9011 都已放通。

4）脚本拉下来后执行过程中又访问失败
优先通过 CN-Proxy 的代理地址去拉取脚本，这样脚本内的常见 https:// 链接也会一起被改写为代理路径。

建议：如果要长期对外使用，请限制来源 IP，避免代理被公网滥用。

八、项目地址#

CN Proxy

GitHub：https://github.com/Assute/cn_proxy.git
Gitee：https://gitee.com/Assute/cn_proxy.git

DL Proxy

GitHub：https://github.com/Assute/dl_proxy.git
Gitee：https://gitee.com/Assute/dl_proxy.git

Linux 服务器自动备份神器：Rsync 备份管理工具

Fri, 06 Mar 2026 10:05:44 GMT

Linux 服务器自动备份神器：Rsync 备份管理工具#

在服务器运维中，数据备份是一项至关重要的工作。手动备份不仅繁琐，还容易遗漏。今天分享一个自己写的 Rsync 备份管理工具，它可以帮你轻松实现自动化增量备份，支持定时任务和开机自启。

视频教程#

快速了解工具的使用方法，请观看视频教程：

一、功能特点#

这个脚本具备以下核心功能：

添加备份任务：通过交互式菜单配置备份源、目标服务器、SSH 端口、密码等信息
修改备份任务：随时调整已有备份任务的配置
删除备份任务：一键清理不需要的备份任务
灵活的定时设置：支持按分钟设置备份间隔，可单独修改或批量修改
增量同步：基于 Rsync，只传输变化的部分，大幅节省带宽和时间
开机自启动：服务器重启后自动恢复备份任务
自动依赖安装：首次运行自动检测并安装 rsync、sshpass、cron 等依赖

二、工作原理#

脚本的核心工作流程如下：

1
用户配置 -> 生成配置文件 -> 生成 Rsync 备份脚本 -> 添加 Cron 定时任务

2.1 配置文件管理#

每个备份任务会生成一个独立的配置文件，存储在 /opt/backup/backup_configs/ 目录下：

Terminal window

1
BACKUP_NAME="mybackup"
2
SOURCE_FOLDER="/data/important"
3
USERNAME="root"
4
HOST="192.168.1.100"
5
PORT="22"
6
DEST_FOLDER="/backup"
7
PASSWORD="your_password"
8
INTERVAL="60"

2.2 Rsync 增量备份#

脚本使用 rsync + sshpass 实现自动化增量备份。相比传统的 SCP 全量复制，Rsync 只传输文件变化的部分，效率更高。每个备份任务会生成一个对应的 Bash 脚本，自动处理：

通过 sshpass 自动传递密码，无需交互
使用 -avz 参数保留文件属性并压缩传输
自动接受 SSH 主机密钥
日志记录，超过 5MB 自动清空

2.3 Cron 定时任务#

脚本会根据你设置的时间间隔，自动生成合适的 Cron 表达式：

间隔设置	Cron 表达式
30 分钟	`/30 * * *`
60 分钟	`0 * * * *`
120 分钟	`0 /2 * *`

三、使用方法#

3.1 一键安装#

国内服务器：

Terminal window

1
bash <(curl -sL https://gitee.com/Assute/backup_manager/raw/master/backup_manager.sh)

国外服务器：

Terminal window

1
bash <(curl -sL https://raw.githubusercontent.com/Assute/backup_manager/main/backup_manager.sh)

3.2 主菜单界面#

运行后会显示一个美观的交互式菜单：

Rsync 备份管理工具主菜单

3.3 添加备份任务示例#

选择 1. 添加备份 后，按提示输入：

任务名称：如 web_backup，仅支持英文和数字
备份路径：如 /var/www/html
目标服务器：如 192.168.1.100
SSH 端口：默认 22
用户名：默认 root
密码：SSH 登录密码
目标目录：如 /backup/web
备份间隔：如 60，单位为分钟

配置完成后，脚本会：

保存配置文件
生成自动化备份脚本
添加定时任务
设置开机自启
立即执行一次备份

四、目录结构#

脚本运行后会创建以下目录结构：

1
/opt/backup/
2
├── backup_configs/     # 配置文件目录
3
│   └── mybackup.conf
4
├── backup_scripts/     # Rsync 备份脚本目录
5
│   └── mybackup.sh
6
└── backup_logs/        # 日志文件目录
7
    └── mybackup.log

五、查看备份日志#

每个备份任务都有独立的日志文件，记录备份的开始和完成时间：

Terminal window

1
cat /opt/backup/backup_logs/mybackup.log

输出示例：

1
2024-01-15 10:00:01 - 开始备份 /data/important -> root@192.168.1.100:22:/backup
2
2024-01-15 10:00:15 - 备份完成

六、注意事项#

需要 root 权限：脚本需要 root 权限来安装依赖和管理 cron 任务
密码安全：配置文件中存储了明文密码，文件权限已设置为 600，仅 root 可读写
网络要求：确保本机可以通过 SSH 连接到目标服务器
存储空间：请确保目标服务器有足够的存储空间

七、适用场景#

网站数据定时备份到远程服务器
数据库导出文件异地备份
配置文件定期同步
日志文件归档备份

八、总结#

这个 Rsync 备份管理工具通过交互式菜单简化了备份任务的配置过程，结合 sshpass 实现密码自动化，利用 Rsync 增量同步节省带宽，配合 Cron 实现定时执行，是一个实用的服务器备份解决方案。

如果你也有服务器备份的需求，不妨试试这个脚本。

九、项目地址#

GitHub：https://github.com/Assute/backup_manager
Gitee：https://gitee.com/Assute/backup_manager

十、免责声明#

本脚本仅供学习和参考使用，请根据实际环境调整。使用本脚本所造成的任何直接或间接损失，作者不承担任何责任。请在使用前充分测试，并确保已备份重要数据。

禁止将本脚本用于任何非法用途。

电商工具分享｜淘宝订单评价批量检查工具，一键筛出买家真实评价

Fri, 06 Mar 2026 07:27:51 GMT

做淘宝的卖家应该都有这个痛点，想快速看看哪些订单有买家的真实评价，而不是系统自动给的默认好评。

手动一个个点开订单去看？订单少还好，订单一多根本看不过来。

所以我写了一个小工具，帮你批量抓取订单、自动检查评价，把买家主动写的评价筛出来，默认好评直接过滤掉。

这个工具能做什么？#

简单来说就是三步：

输入商品名称和时间范围，工具自动抓取这段时间内所有交易成功的订单
逐个检查每个订单的评价，自动判断是买家主动评价还是系统默认好评
汇总结果，告诉你哪些订单有真实评价、评价内容是什么、是好评还是中差评

核心功能#

智能识别：自动区分“买家主动评价”和“系统默认好评”，不用再一个个人工去翻
评价分类：好评、中评、差评一目了然
可点击链接：日志里直接生成评价详情链接，点一下就能跳转查看原始评价页面
日历选择：内置日历弹窗选日期，不用手动输入
结果导出：支持把结果导出为 JSON 文件，方便后续处理
随时停止：运行过程中可以随时停止，不用等跑完

截图预览#

工具界面截图

使用方法#

方式一：下载 EXE 直接运行#

推荐直接使用，不需要安装 Python，也不需要任何编程知识。

从 GitHub 的 Releases 页面下载 淘宝评价检查工具.exe，双击打开就能用。

方式二：从源码运行#

如果你有 Python 环境，也可以直接跑源码：

Terminal window

1
git clone https://github.com/Assute/taobao-review-checker.git
2
cd taobao-review-checker
3
pip install requests
4
python 淘宝评价检查工具.py

操作步骤#

打开工具，输入你要查询的商品名称
选择起止日期，默认是三个月前
打开浏览器登录淘宝卖家后台，按 F12 获取 Cookie，也可以使用 Cookie Viewer & Exporter 插件一键获取，粘贴到工具里
点击“开始运行”
等待运行完成，查看结果

工具会先分页抓取所有交易成功的订单，然后逐个去检查评价状态。过程中会实时显示进度和日志，跑完后给出汇总报告。

运行效果#

工具运行完成后，会输出类似这样的汇总：

1
============================================================
2
汇总结果
3
============================================================
4
总订单数: 86
5
买家主动评价: 12
6
系统默认好评: 68
7
无评价: 4
8
请求失败: 2

对于有买家主动评价的订单，还会显示评价内容、评价类型（好评 / 中评 / 差评）和评价时间，并附上可直接点击的详情链接。

技术实现#

工具基于 Python 开发，使用 tkinter 做图形界面，requests 发起 HTTP 请求。

主要流程：

调用淘宝已卖出商品接口，按商品名称和时间范围筛选，分页获取所有交易成功的订单号
对每个订单号，请求淘宝评价详情页面，解析 HTML 提取评价内容
通过关键词匹配，例如“系统默认好评”“此用户没有填写评价”等，判断是否为真实评价
汇总统计并展示结果

开源地址#

工具完全开源，代码放在 GitHub 和 Gitee 上，欢迎 Star：

GitHub：https://github.com/Assute/taobao-review-checker
Gitee：https://gitee.com/Assute/taobao-review-checker

基于 CC BY-NC 4.0 协议发布，可以自由使用和修改，但禁止商用。

免责声明#

本工具仅供学习和研究使用，请遵守淘宝平台的相关规定，合理使用。因使用本工具产生的任何问题，作者不承担任何责任。

如果觉得好用，欢迎去仓库点个 Star 支持一下。有问题也可以在 GitHub 上提 Issue。

电商工具分享｜生意参谋关键词批量采集工具，一键提取全类目搜索词

Fri, 06 Mar 2026 03:00:00 GMT

做电商运营的朋友都知道，生意参谋是淘宝卖家最重要的数据分析工具之一。而其中的搜索词分析功能，更是选品、优化标题、直通车投放的核心数据来源。

但问题来了，手动一个个类目去查关键词，效率实在太低了。

淘宝有几十个一级类目，每个下面还有二级、三级类目，全部手动采集一遍，少说也要好几天。更别说你还需要定期更新数据了。

所以我开发了这款工具，帮你自动完成这件事。

一、这个工具能做什么？#

简单来说，它可以自动登录生意参谋，按类目层级批量采集搜索关键词数据，最后导出为 Excel 文件。

具体功能包括：

自动化采集：通过 Selenium 自动操控 Chrome 浏览器，模拟人工操作，从生意参谋页面批量提取搜索关键词数据。
多级类目遍历：支持一级、二级、三级类目的自动遍历，不用手动一个个点。
智能筛选：可以设置搜索人气阈值，默认 150，自动过滤掉没有价值的长尾词，只保留有搜索量的关键词。
自动翻页：每个类目最多采集 6 页数据，自动翻页，不需要人工干预。
Excel 导出：采集到的数据自动保存为 Excel 文件，按类目分类整理，拿来就能用。
暂停 / 继续：采集过程中可以随时暂停和继续，不怕中途有事要离开。
多浏览器并行：支持多个浏览器实例同时采集，大幅提升效率。
图形界面：基于 tkinter 开发了可视化操作界面，不需要懂代码也能用。

截图预览#

工具界面截图

二、怎么使用？#

方式一：直接下载 EXE 运行#

推荐小白用户使用。我已经把程序打包成了 exe 文件，不需要安装 Python 环境，双击就能运行。

下载地址：

方式二：从源码运行#

适合有 Python 基础的用户。

安装 Python 3.10 以上版本
安装依赖：

Terminal window

1
pip install selenium openpyxl pywin32 webdriver-manager

运行：

Terminal window

1
python 生意参谋关键词获取工具.py

三、使用步骤#

步骤	操作说明
第一步	启动程序，打开工具界面
第二步	在程序打开的 Chrome 浏览器中登录生意参谋账号
第三步	选择你想要采集的目标类目层级
第四步	点击开始采集，程序自动遍历所有类目，逐页提取关键词数据
第五步	采集完成后，数据自动导出为 Excel 文件，打开即可使用

整个过程中你可以随时暂停或停止，非常灵活。

四、可自定义配置#

如果你有一定的编程基础，还可以在源码中调整以下参数：

参数	默认值	说明
`min_popularity_threshold`	`150`	搜索人气筛选阈值，低于此值的关键词会被过滤
`max_pages`	`6`	每个类目最大采集页数
`exclude_level1_serials`	`[4,34,52,53,54,58,59,60]`	排除不需要采集的一级类目序号

五、开源地址#

这个工具我已经完全开源，代码托管在 GitHub 和 Gitee 上，欢迎 Star 和 Fork。

GitHub：https://github.com/Assute/sycm-keyword-tool
Gitee：https://gitee.com/Assute/sycm-keyword-tool

本项目采用 CC BY-NC 4.0 协议，你可以自由使用和修改，但禁止用于商业用途，使用时请注明出处。

六、免责声明#

本工具仅供学习和研究使用，请遵守淘宝平台的相关使用条款和规定，合理使用。因使用本工具产生的任何问题，作者不承担任何责任。

如果你觉得这个工具对你有帮助，欢迎在评论区留言交流，也欢迎到 GitHub 上给个 Star 支持一下。

有任何问题或建议，可以在 GitHub 上提 Issue，我会尽快回复。

Cookie Viewer & Exporter 一键查看并导出网站 Cookie 的 Chrome 扩展

Fri, 06 Mar 2026 02:30:00 GMT

做接口调试的时候，经常需要从浏览器里复制 Cookie 粘贴到 cURL、Postman 或者自动化脚本里。每次都要打开 DevTools -> Application -> Cookies，然后一条条拼接，实在繁琐。所以我写了一个小工具 Cookie Viewer & Exporter，点一下就搞定。

插件预览#

Cookie Viewer & Exporter 插件预览

它能做什么？#

非常简单，就三件事。

查看：点击扩展图标，自动读取当前网站的所有 Cookie，格式化显示在弹窗中
复制：一键复制为 name=value; name=value 格式，直接能粘贴到 HTTP 请求头里用
下载：一键导出为 cookie.txt 文件，保存到默认下载目录

输出的格式就是标准的 HTTP Cookie 请求头格式，复制出来可以直接用，不用再手动拼接。

使用场景#

如果你经常做以下这些事，这个插件能帮你省不少时间。

接口调试：需要在 Postman、Insomnia 或 cURL 中携带 Cookie 发请求
自动化脚本：Python、Node.js 等脚本需要模拟登录态
问题排查：快速检查当前网站存了哪些 Cookie，值是什么
数据采集：需要快速获取登录后的 Cookie 用于爬虫

安装方法#

目前还没有上架 Chrome 应用商店，需要通过开发者模式手动加载。

从 GitHub 下载源码：

Terminal window

1
git clone https://github.com/Assute/cookie-viewer.git

或者从 Gitee（国内镜像）下载：

Terminal window

1
git clone https://gitee.com/Assute/cookie-viewer.git

打开 Chrome，访问 chrome://extensions/
开启右上角的开发者模式
点击加载已解压的扩展程序，选择下载的项目文件夹

怎么用？#

安装完成后，使用非常简单。

访问你想获取 Cookie 的网站，比如已经登录的后台
点击浏览器工具栏上的扩展图标
弹窗会自动显示当前网站的所有 Cookie
点击 复制到剪贴板 或 下载为 cookie.txt

就这么简单，全程不需要打开开发者工具。

输出格式#

假设当前网站有三条 Cookie，输出内容长这样。

1
session_id=abc123; token=xyz456; user=assute

可以直接作为 HTTP 请求头中 Cookie 字段的值使用。比如在 cURL 中：

Terminal window

1
curl -H "Cookie: session_id=abc123; token=xyz456; user=assute" https://example.com/api/data

技术细节#

基于 Chrome Extension Manifest V3 开发
通过 chrome.cookies.getAll() 获取当前页面的 Cookie
通过 navigator.clipboard.writeText() 实现剪贴板复制
通过 chrome.downloads.download() 触发文件下载
纯原生 JavaScript，无任何第三方依赖，整个插件只有 3 个文件
代码开源，协议为 Apache-2.0

项目地址#

GitHub: https://github.com/Assute/cookie-viewer
Gitee: https://gitee.com/Assute/cookie-viewer

插件非常轻量，代码也很简单，感兴趣的话可以看看源码，也欢迎 Star 支持。有问题或建议，欢迎提交 Issue。

Browser Proxy Manager 一款轻量的 Chrome 代理切换扩展

Fri, 06 Mar 2026 02:00:00 GMT

日常开发和测试中，经常需要切换浏览器代理，手动改系统设置实在太麻烦。于是我写了一个 Chrome 扩展 Browser Proxy Manager，可以在浏览器内一键切换代理，还支持通过 API 自动获取和轮换代理 IP。

⚠️ 声明：本项目目前为半成品，部分功能尚未经过完整测试，可能存在未知问题。如果你在使用中遇到 Bug，欢迎在 GitHub 提交 Issue。

它能做什么？#

这个扩展提供了两种代理模式，覆盖了大多数使用场景。

模式一：手动代理#

适合有固定代理服务器的用户。在弹窗中填入代理地址、端口，选择协议类型（HTTP / HTTPS / SOCKS5），保存即可生效。支持填写用户名和密码进行认证。

模式二：API 自动代理#

这是这个插件的核心亮点。如果你使用的是按量计费的代理服务，比如各种 IP 代理平台，通常会提供一个 API 接口来获取代理 IP。只需要把 API 地址填进去，插件就会：

自动调用 API 获取新的代理 IP
验证代理是否可用
应用到浏览器
到期后自动换一个新的 IP

整个过程完全自动化，不需要你手动操作。

主要特性#

代理验证：每次获取新 IP 后，会先测试连通性，确认可用才会启用
定时轮换：支持 1 / 3 / 5 / 10 / 30 分钟的自动换 IP 周期
失败重试：获取失败时自动重试，递增延迟，连续 5 次失败后暂停
实时状态：弹窗显示当前代理 IP 和剩余时间倒计时
智能绕行：自动将 API 域名加入绕行列表，避免循环请求
多格式兼容：支持纯文本 ip:port 和多种 JSON 格式的 API 响应
状态持久化：重启浏览器后自动恢复代理设置

安装方法#

目前还没有上架 Chrome 应用商店，需要通过开发者模式手动加载。

从 GitHub 下载源码：

Terminal window

1
git clone https://github.com/Assute/browser-proxy-manager.git

或者从 Gitee（国内镜像）下载：

Terminal window

1
git clone https://gitee.com/Assute/browser-proxy-manager.git

打开 Chrome，访问 chrome://extensions/
开启右上角的开发者模式
点击加载已解压的扩展程序，选择下载的项目文件夹

使用演示#

安装完成后，点击浏览器工具栏上的扩展图标，会弹出设置面板。

手动代理模式

API代理模式

顶部有 手动代理 和 API代理 两个标签页，点击切换
填写对应的配置信息，点击保存即可
底部会实时显示当前代理状态、IP 地址和剩余有效时间

两种模式互斥，开启一种会自动关闭另一种。

API 响应格式#

插件兼容多种常见的代理 API 返回格式，基本上拿来就能用。

格式	示例
纯文本	`123.45.67.89:8080`
JSON（proxy 字段）	`{"proxy": "123.45.67.89:8080"}`
JSON（ip 字段）	`{"ip": "123.45.67.89:8080"}`
JSON（带绕行列表）	`{"proxy": "123.45.67.89:8080", "bypass": ["api.example.com"]}`

技术细节#

基于 Chrome Extension Manifest V3 开发
使用 Chrome Proxy API 控制浏览器代理设置
使用 Chrome Alarms API 实现定时轮换
纯原生 JavaScript，无任何第三方依赖
代码开源，协议为 Apache-2.0

项目地址#

GitHub: https://github.com/Assute/browser-proxy-manager
Gitee: https://gitee.com/Assute/browser-proxy-manager

如果觉得有用，欢迎 Star 支持一下。遇到问题或有功能建议，也欢迎提交 Issue。

Firefly 布局系统详解

Sat, 03 Jan 1970 00:00:00 GMT

📖 概述#

Firefly 提供了灵活的布局系统，允许您根据内容需求和个人喜好自定义博客的视觉呈现方式。布局系统主要包括侧边栏布局和文章列表布局两个维度，它们相互配合，共同决定了页面的整体结构。

本文将详细介绍 Firefly 的各种布局模式、它们的特点、使用场景，以及不同布局组合的效果。

左侧边栏+列表布局

右侧边栏+网格布局

左侧边栏+三列网格布局

双侧边栏+列表布局

双侧边栏+网格布局

双侧边栏+网格瀑布流布局

一、侧边栏布局系统#

侧边栏是博客页面的重要组成部分，用于展示导航、分类、标签、统计信息等辅助内容。Firefly 支持两种侧边栏布局模式。

1.1 单侧边栏模式#

1.1.1 左侧边栏 (position: “left”)#

左侧边栏布局

1.1.2 右侧边栏 (position: “right”)#

右侧边栏布局

特点#

侧边栏固定在页面其中一侧
文章阅读区域体验更佳，更宽敞
更加简约，没有那么紧凑

适用场景#

传统博客风格
强调导航和分类的博客
需要突出用户资料的个人博客
内容为主，辅助信息次之的场景

Tip

可以通过showBothSidebarsOnPostPage配置是否在文章详情页显示双侧边栏

当position为left或right时开启此项后，文章详情页将显示双侧边栏，主页等其他页面保持单侧边栏

适用在只想用单侧栏，但在文章详情页想用对侧栏的目录等组件的场景

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
  showBothSidebarsOnPostPage: true, // 是否在文章详情页显示双侧边栏
5
};

1.2 双侧边栏模式 (position: “both”)#

特点#

左右两侧同时存在侧边栏
主内容区域位于中间
最大化利用屏幕空间
可以展示更多辅助信息
适合宽屏显示器

布局结构#

双侧边栏+列表布局

双侧边栏+网格布局

适用场景#

宽屏桌面端浏览
信息密集型博客
需要展示大量辅助内容
专业性强的技术博客

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

二、文章列表布局系统#

文章列表是博客首页和归档页的核心内容，Firefly 提供两种展示方式，并支持多种网格配置。

2.1 列表模式 (defaultMode: “list”)#

特点#

单列纵向排列
显示文章封面图
展示更多文章摘要
适合深度阅读

列表布局结构#

列表模式布局

优点#

✅ 视觉冲击力强，封面图吸引眼球
✅ 可以展示更多文章信息（摘要、标签等）
✅ 适合图片内容丰富的博客
✅ 移动端友好，单列更易阅读
✅ 兼容所有侧边栏配置（单侧、双侧）

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list", // 列表模式
4
    allowSwitch: true,   // 允许用户切换
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

特点#

自适应列数，根据浏览器宽度自动调整
紧凑布局，信息密度高
适合快速浏览

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

网格布局

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    allowSwitch: true,
5
    grid: {
6
      masonry: true,      // 开启瀑布流
7
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
8
    },
9
  },
10
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

瀑布流布局

智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

三、布局组合指南#

Firefly 允许您自由组合侧边栏和文章列表布局。以下是各种组合的效果说明。

3.1 布局选择建议#

侧边栏模式	文章列表模式	推荐度	适用场景
单侧边栏	列表模式	⭐⭐⭐⭐⭐	摄影、设计、生活类博客，强调图片和沉浸感
单侧边栏	网格模式	⭐⭐⭐⭐⭐	技术、笔记类博客，平衡阅读与检索效率
双侧边栏	列表模式	⭐⭐⭐⭐⭐	需要展示大量侧边栏信息的站点
双侧边栏	网格模式	⭐⭐⭐⭐⭐	极客风格，追求最高信息密度

四、响应式布局行为#

Firefly 的布局系统具有智能的响应式设计，会根据屏幕尺寸自动调整。

4.1 智能降级规则#

为了保证最佳阅读体验，系统会在屏幕变窄时自动调整布局：

网格列数自动减少：网格模式的列数由 columnWidth 和容器宽度自动决定，屏幕越窄列数越少。
网格模式 -> 列表模式：当屏幕宽度小于 1200px（平板和手机）时，网格模式会自动切换为单列列表模式，以保证卡片内容的可读性。
双侧边栏 -> 单侧边栏：当屏幕宽度小于 1280px 时，会根据tabletSidebar配置显示单侧边栏，隐藏其中一个侧边栏，文章目录导航会切换成浮动目录导航。

五、常见问题#

Q1: 为什么在手机上看不到网格效果？#

A: 为了保证阅读体验，Firefly 在屏幕宽度小于 1200px 时会自动强制切换为列表模式。手机屏幕太窄，不适合展示多列网格。

Q2: 布局切换按钮在哪里？#

A: 布局切换按钮位于导航栏右侧。它仅在屏幕宽度 ≥ 1200px 时显示，因为在小屏幕上系统强制使用列表模式，无需切换。

Q3: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

六、总结#

Firefly 的布局系统给予了您更大的自由度，您都可以通过简单的配置实现。

我们建议您根据自己的内容类型和目标读者的设备偏好，尝试不同的组合，找到最适合您的博客形态。

Firefly 代码块示例

Sat, 03 Jan 1970 00:00:00 GMT

在这里，我们将探索如何使用 Expressive Code 展示代码块。提供的示例基于官方文档，您可以参考以获取更多详细信息。

表达性代码#

语法高亮#

语法高亮

常规语法高亮#

1
console.log('此代码有语法高亮!')

渲染 ANSI 转义序列#

Terminal window

1
ANSI colors:
2
- Regular: Red Green Yellow Blue Magenta Cyan
3
- Bold:    Red Green Yellow Blue Magenta Cyan
4
- Dimmed:  Red Green Yellow Blue Magenta Cyan
5

6
256 colors (showing colors 160-177):
7
160 161 162 163 164 165
8
166 167 168 169 170 171
9
172 173 174 175 176 177
10

11
Full RGB colors:
12
ForestGreen - RGB(34, 139, 34)
13

14
Text formatting: Bold Dimmed Italic Underline

编辑器和终端框架#

编辑器和终端框架

代码编辑器框架#

my-test-file.js

1
console.log('标题属性示例')

src/content/index.html

1
<div>文件名注释示例</div>

终端框架#

Terminal window

1
echo "此终端框架没有标题"

PowerShell 终端示例

1
Write-Output "这个有标题!"

覆盖框架类型#

1
echo "看，没有框架!"

PowerShell Profile.ps1

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

标记整行和行范围#

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

选择行标记类型 (mark, ins, del)#

line-markers.js

1
function demo() {
2
  console.log('此行标记为已删除')
3
  // 此行和下一行标记为已插入
4
  console.log('这是第二个插入行')
5

6
  return '此行使用中性默认标记类型'
7
}

为行标记添加标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === 'string' ? <span>{children}</span> : children)}
12
</button>

在单独行上添加长标签#

labeled-line-markers.jsx显示更多显示更少

1
<button
2
  role="button"
3
  {...props}
4

5
  value={value}
6
  className={buttonClassName}
7

8
  disabled={disabled}
9
  active={active}
10
>
11

12
  {children &&
13
    !active &&
14
    (typeof children === 'string' ? <span>{children}</span> : children)}
15
</button>

显示更多显示更少

使用类似 diff 的语法#

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

结合语法高亮和类似 diff 的语法#

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

标记行内的单独文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

正则表达式#

1
console.log('单词 yes 和 yep 将被标记。')

转义正斜杠#

Terminal window

1
echo "Test" > /home/test.txt

选择内联标记类型 (mark, ins, del)#

1
function demo() {
2
  console.log('这些是插入和删除的标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

为每个块配置自动换行#

1
// 启用换行的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

配置换行的缩进#

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 直到块末尾的所有代码将再次被折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

显示更多显示更少

行号#

行号

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候!')
3
console.log('我在第3行')

// 此块禁用行号
console.log('你好?')
console.log('抱歉，你知道我在第几行吗?')

更改起始行号#

5
console.log('来自第5行的问候!')
6
console.log('我在第6行')

Firefly 一款清新美观的 Astro 博客主题模板

Fri, 02 Jan 1970 00:00:00 GMT

🌟 项目概述#

Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。

🖥️在线预览： Firefly - Demo site

🏠我的博客： https://blog.cuteleaf.cn

📝Firefly使用文档： https://docs-firefly.cuteleaf.cn

⭐Firefly开源地址：https://github.com/CuteLeaf/Firefly

⭐Fuwari开源地址：https://github.com/saicaca/fuwari

CuteLeaf

Firefly

Waiting for api.github.com...

Waiting for api.github.com...

00K

Waiting...

Firefly

🚀 技术架构#

静态站点生成: 基于 Astro ，提供极快的加载速度和优秀的 SEO 优化
TypeScript 支持: 完整的类型安全，提升开发体验和代码质量
响应式设计: 使用 Tailwind CSS 构建，完美适配桌面端和移动端
组件化开发: 支持 Astro、Svelte 组件，灵活可扩展

📖 配置说明#

📚 详细配置文档: 查看 Firefly使用文档获取完整的配置指南

KaTeX 数学公式示例

Fri, 02 Jan 1970 00:00:00 GMT

本文展示了 Firefly 主题对 KaTeX 数学公式的渲染支持。

行内公式 (Inline)#

行内公式使用单个 $ 符号包裹。

例如：欧拉公式 eiπ+1=0e^{i\pi} + 1 = 0eiπ+1=0 是数学中最优美的公式之一。

质能方程 E=mc2E = mc^2E=mc2 也是家喻户晓。

块级公式 (Block)#

块级公式使用两个 $$ 符号包裹，会居中显示。

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=πx=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}x=2a−b±b2−4ac

复杂示例#

矩阵 (Matrices)#

(abcd)(αβγδ)=(aα+bγaβ+bδcα+dγcβ+dδ)\begin{pmatrix} a & b \\ c & d \end{pmatrix} \begin{pmatrix} \alpha & \beta \\ \gamma & \delta \end{pmatrix} = \begin{pmatrix} a\alpha + b\gamma & a\beta + b\delta \\ c\alpha + d\gamma & c\beta + d\delta \end{pmatrix}(acbd)(αγβδ)=(aα+bγcα+dγaβ+bδcβ+dδ)

极限与求和 (Limits and Sums)#

∑n=1∞1n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}n=1∑∞n21=6π2lim⁡x→0sin⁡xx=1\lim_{x \to 0} \frac{\sin x}{x} = 1x→0limxsinx=1

麦克斯韦方程组 (Maxwell’s Equations)#

∇⋅E=ρε0∇⋅B=0∇×E=−∂B∂t∇×B=μ0J+μ0ε0∂E∂t\begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \\ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\ \nabla \times \mathbf{B} &= \mu_0\mathbf{J} + \mu_0\varepsilon_0\frac{\partial \mathbf{E}}{\partial t} \end{aligned}∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E

化学方程式 (Chemical Equations)#

CHX4+2 OX2→COX2+2 HX2O\ce{CH4 + 2O2 -> CO2 + 2H2O}CHX4+2OX2COX2+2HX2O

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

Firefly 文章加密

Fri, 02 Jan 1970 00:00:00 GMT

这是一篇密码保护的示例文章，用于演示文章加密功能。

MDX 格式文章示例

Fri, 02 Jan 1970 00:00:00 GMT

Tip

Firefly 支持 MDX 和 Markdown 两种类型的文章，你可以在文章中混合使用两种格式，如果没有特别复杂内容和需求，推荐使用 Markdown 格式就够了。

Markdown 和 MDX 的区别#

Markdown (MD) 是一种轻量级标记语言，允许用户使用纯文本格式编写文档，然后将其转换为格式化的HTML。它因其简洁易用的语法而广受欢迎，特别适合编写文档和博客文章。
MDX 是一种扩展了 Markdown 语法的格式，允许在 Markdown 文档中无缝地插入 JSX 代码。通过 MDX，用户可以在文档中嵌入 React 组件，从而实现更丰富的交互性和动态性。

特性	Markdown	MDX
基础语法	支持 (CommonMark)	支持 (CommonMark)
HTML 标签	支持	支持 (作为 JSX)
组件导入	不支持	支持 (import)
动态数据	不支持	支持 (JS 表达式)
样式定制	有限 (class/style)	灵活 (className/CSS-in-JS)

使用组件#

这是一个图标组件：

1
import { Icon } from 'astro-icon/components'
2

3
<div class="flex items-center gap-2 my-4">
4
  <Icon name="fa7-solid:rocket" class="text-4xl text-red-500" />
5
  <span>火箭发射！</span>
6
</div>

火箭发射！

使用 JSX#

你也可以直接写 HTML/JSX：

1
<div className="p-4 bg-blue-100 dark:bg-blue-900 rounded-lg my-4">
2
  这是一个自定义样式的 div 块，使用了 Tailwind CSS 类。
3
</div>

这是一个自定义样式的 div 块，使用了 Tailwind CSS 类。

简单的变量导出#

1
export const year = new Date().getFullYear()
2

3
今年是 {year} 年。

今年是 2026 年。

更多信息，请查看 MDX 文档

Firefly 简单使用指南

Fri, 02 Jan 1970 00:00:00 GMT

这个博客模板是基于 Astro 构建的。对于本指南中未提及的内容，您可以在 Astro 文档中找到答案。

文章的 Front-matter#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

属性	描述
`title`	文章标题。
`published`	文章发布日期。
`updated`	文章更新日期。如果未设置，将默认使用发布日期。
`pinned`	是否将此文章置顶在文章列表顶部。
`description`	文章的简短描述。显示在首页上。
`image`	文章封面图片路径。 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：`public` 目录中的图片 3. 不带任何前缀：相对于 markdown 文件的路径
`tags`	文章标签。
`category`	文章分类。
`lang`	文章语言代码（如 `zh-CN`）。仅当文章语言与站点默认语言不同时设置。
`licenseName`	文章内容的许可证名称。
`licenseUrl`	文章内容的许可证链接。
`author`	文章作者。
`sourceLink`	文章内容的来源链接或参考。
`draft`	如果这篇文章仍是草稿，则不会显示。
`comment`	是否启用此文章的评论功能。默认为 `true`。
`slug`	自定义文章 URL 路径。如果不设置，将使用文件名作为 URL。
`password`	文章密码。设置后文章内容将被 AES-256-GCM 加密，访客需输入密码才能查看。
`passwordHint`	密码提示。显示在密码输入框上方，帮助访客回忆密码，也可以不加。

文章文件的放置位置#

您的文章文件应放置在 src/content/posts/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

示例 1：使用文件名作为 URL#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/my-first-blog-post

示例 2：自定义 Slug#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/hello-world

示例 3：其他语言文件名使用Slug#

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

文件：src/content/posts/如何使用Firefly博客主题.md

URL：/posts/how-to-use-firefly-blog-theme

Slug 使用建议#

使用英文和连字符：my-awesome-post 而不是 my awesome post
保持简洁：避免过长的 slug
具有描述性：让 URL 能够反映文章内容
避免特殊字符：只使用字母、数字和连字符
保持一致性：在整个博客中使用相似的命名模式

注意事项#

Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
如果多个文章使用相同的 slug，后面的文章会覆盖前面的
Slug 会自动转换为小写

Markdown Mermaid 图表

Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、甘特图、类图和状态图。

流程图示例#

流程图非常适合表示流程或算法步骤。

graph TD A[开始] --> B{条件检查} B -->|是| C[处理步骤 1] B -->|否| D[处理步骤 2] C --> E[子过程] D --> E subgraph E [子过程详情] E1[子步骤 1] --> E2[子步骤 2] E2 --> E3[子步骤 3] end E --> F{另一个决策} F -->|选项 1| G[结果 1] F -->|选项 2| H[结果 2] F -->|选项 3| I[结果 3] G --> J[结束] H --> J I --> J

时序图示例#

时序图显示对象之间随时间的交互。

sequenceDiagram participant User as 用户 participant WebApp as 网页应用 participant Server as 服务器 participant Database as 数据库 User->>WebApp: 提交登录请求 WebApp->>Server: 发送认证请求 Server->>Database: 查询用户凭据 Database-->>Server: 返回用户数据 Server-->>WebApp: 返回认证结果 alt 认证成功 WebApp->>User: 显示欢迎页面 WebApp->>Server: 请求用户数据 Server->>Database: 获取用户偏好 Database-->>Server: 返回偏好设置 Server-->>WebApp: 返回用户数据 WebApp->>User: 加载个性化界面 else 认证失败 WebApp->>User: 显示错误消息 WebApp->>User: 提示重新输入 end

甘特图示例#

甘特图非常适合显示项目进度和时间线。

gantt title 网站开发项目时间线 dateFormat YYYY-MM-DD axisFormat %m/%d section 设计阶段需求分析 :a1, 2023-10-01, 7d UI设计 :a2, after a1, 10d 原型创建 :a3, after a2, 5d section 开发阶段前端开发 :b1, 2023-10-20, 15d 后端开发 :b2, after a2, 18d 数据库设计 :b3, after a1, 12d section 测试阶段单元测试 :c1, after b1, 8d 集成测试 :c2, after b2, 10d 用户验收测试 :c3, after c2, 7d section 部署生产环境部署 :d1, after c3, 3d 发布 :milestone, after d1, 0d

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

classDiagram class User { +String username +String password +String email +Boolean active +login() +logout() +updateProfile() } class Article { +String title +String content +Date publishDate +Boolean published +publish() +edit() +delete() } class Comment { +String content +Date commentDate +addComment() +deleteComment() } class Category { +String name +String description +addArticle() +removeArticle() } User "1" -- "*" Article : 写作 User "1" -- "*" Comment : 发表 Article "1" -- "*" Comment : 拥有 Article "1" -- "*" Category : 属于

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

stateDiagram-v2 [*] --> 草稿草稿 --> 审核中 : 提交审核中 --> 草稿 : 拒绝审核中 --> 已批准 : 批准已批准 --> 已发布 : 发布已发布 --> 已归档 : 归档已发布 --> 草稿 : 撤回 state 已发布 { [*] --> 活跃活跃 --> 隐藏 : 临时隐藏隐藏 --> 活跃 : 恢复活跃 --> [*] 隐藏 --> [*] } 已归档 --> [*]

饼图示例#

饼图非常适合显示比例和百分比数据。

pie title 网站流量来源分析 "搜索引擎" : 45.6 "直接访问" : 30.1 "社交媒体" : 15.3 "推荐链接" : 6.4 "其他来源" : 2.6

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了如何使用流程图、时序图、甘特图、类图、状态图和饼图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。Mermaid 会自动将这些描述转换为美观的可视化图表。

尝试在您的下一篇技术博客文章或项目文档中使用 Mermaid 图表 - 它们将使您的内容更加专业且更易理解！

Markdown 扩展功能

Thu, 01 Jan 1970 00:00:00 GMT

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，在页面加载时，仓库信息会从 GitHub API 获取。

CuteLeaf

Firefly

Waiting for api.github.com...

00K

Waiting...

使用代码 ::github{repo="CuteLeaf/Firefly"} 创建 GitHub 仓库卡片。

1
::github{repo="CuteLeaf/Firefly"}

提醒框(Admonitions)配置#

Firefly 采用了 rehype-callouts 插件，支持了三种风格的提醒框主题：GitHub、Obsidian 和 VitePress。您可以在 src/config/siteConfig.ts 中进行配置：

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // 选项: "github" | "obsidian" | "vitepress"
5
    theme: "github",
6
  },
7
  // ...
8
};

注意：更改配置后需要重启开发服务器才能生效。

以下是各个主题支持的类型列表，每个主题风格和语法不同，可根据喜好选择。

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

GitHub

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

显示更多显示更少

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

点击展开 Obsidian 语法列表

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。

显示更多显示更少

Obsidian

3. VitePress 主题风格#

VitePress 风格提供了一套现代化的、扁平的默认样式。目前仅包含与 GitHub 一致的 5 种 基础类型。

点击展开 VitePress 语法列表

1
> [!NOTE] NOTE
2
> 对应 GitHub 的 Note。
3

4
> [!TIP] TIP
5
> 对应 GitHub 的 Tip。
6

7
> [!IMPORTANT] IMPORTANT
8
> 对应 GitHub 的 Important。
9

10
> [!WARNING] WARNING
11
> 对应 GitHub 的 Warning。
12

13
> [!CAUTION] CAUTION
14
> 对应 GitHub 的 Caution。
15

16
> [!TIP] 自定义标题
17
> VitePress 风格同样支持自定义标题。

显示更多显示更少

VitePress

4. Docusaurus 风格语法#

仅支持语法，风格保持跟上面三个主题相同。

点击展开 Docusaurus 语法列表

支持以下类型的提醒框：note tip important warning caution

1
:::note
2
突出显示用户应该考虑的信息，即使在快速浏览时也是如此。
3
:::
4

5
:::tip
6
可选信息，帮助用户更成功。
7
:::
8

9
:::important
10
用户成功所必需的关键信息。
11
:::
12

13
:::warning
14
由于潜在风险需要用户立即注意的关键内容。
15
:::
16

17
:::caution
18
行动的负面潜在后果。
19
:::
20

21
:::tip[自定义标题]
22
可选信息，帮助用户更成功。
23
:::

显示更多显示更少

剧透#

您可以为文本添加剧透。文本也支持 Markdown 语法。

内容被隐藏了哈哈！

1
内容 :spoiler[被隐藏了 **哈哈**]！

图片画廊网格 (Image Grid)#

您可以使用 [grid] 和 [/grid] 标签将多张图片纵向并排展示。这对于展示照片画廊或对比图非常有用。系统会自动根据包裹在其中的图片数量（最多支持并排展示4张）以响应式网格进行布局。

自动补齐图片高度： 同一排中如果有高度、大小或者比例不一的图片，会像「九宫格画廊相册」一样自动撑满。较短或不协调的图片会自动使用 object-cover 进行完美中心裁剪补充视野。图片边框水平彻底对齐无缝隙，但被裁剪后，只有点击图片通过灯箱才能查看完整图片，所以建议尽量避免使用长宽比例不一致的图片在同一排中。

图注恒定底端对齐： 不论上面的图片长宽如何变化，在同一行的所有图像解释文字（图注）都会对标到一条完美的水平基线上了。

示例图片一

示例图片二

基本语法

1
[grid]
2
![示例图片一](./images/firefly1.avif)
3
![示例图片二](./images/firefly2.avif)
4
![示例图片二](./images/firefly3.avif)
5
[/grid]

Markdown 教程

Thu, 01 Jan 1970 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

在文章中嵌入视频

Thu, 01 Jan 1970 00:00:00 GMT

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

1
---
2
title: 在文章中嵌入视频
3
published: 2023-10-19
4
// ...
5
---
6

7
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

Assute

Docker 安装与常用指令速查

一、安装 Docker#

二、启动并设置开机自启#

三、Docker 常用指令#

VS Code 连接服务器教程（Remote SSH）

第一步：打开远程资源管理器，添加 SSH#

第二步：输入连接命令#

第三步：选择第一个配置文件#

第四步：连接服务器#

第五步：输入服务器密码#

第六步：连接成功后打开文件夹#

第七步：选择目录并再次输入密码#

完成#

Twitter Bot V2 部署与使用教程

一、先修改配置文件#

二、启动项目#

方式一：Docker 一键部署#

方式二：安装依赖后用 Python 启动#

三、打开 Telegram 机器人#

四、打开后台#

五、设置套餐#

六、设置支付接口和 TGAPI#

七、创建群组并给机器人权限#

八、获取群组 ID 并添加群组#

九、添加要同步的用户名#

十、添加 Cookie#

十一、开始全量同步#

十二、定时更新#

十三、订阅信息#

十四、仓库地址#

十五、最后提醒#

Telegram API 申请与部署教程（图文）

一、先准备家宽代理#

二、打开申请页面并登录#

三、填写资料并提交#

四、保存 App api_id 和 App api_hash#

五、Docker 一键部署 TGAPI#

六、部署完成后怎么用#

七、注意事项#

用 Go 写一个网站中转加速服务

这个项目是做什么的#

为什么要单独做这个服务#

目前已经支持的内容#

怎么运行#

为什么选择 Go#

项目地址#

企业微信自建应用通知教程：把应用管理做成消息渠道

首页图片#

一、先说它适合做什么#

二、后台入口在哪里#

三、创建完以后要记住哪几个值#

四、接收通知的人怎么确定#

五、程序发送通知的基本流程#

第一步：获取 access_token#

第二步：发送应用消息#

六、用 curl 测试一遍#

1）获取 token#

2）发送测试消息#

七、Node.js 示例#

八、做成“通知渠道”时怎么理解#

九、最容易踩坑的地方#

1）接收人不在应用可见范围里#

2）把姓名当成 UserID#

3）Secret 拿错#

4）接口通了，但人没看到通知#

5）想发到“普通微信”里#

十、适合接到哪些项目里#

官方参考#

CF-dns：Cloudflare DNS 多域名管理面板

页面效果#

登录界面#

首页#

添加域名#

域名管理#

这个项目具体做什么？#

主要功能#

技术栈#

运行方式#

一键安装#

第一步：获取 `access_token`#

六、用 `curl` 测试一遍#

2）把姓名当成 `UserID`#

3）`Secret` 拿错#

1）提示 `openclaw.json` 不存在#