感谢你能来到这里，查看 Server饭 的文档。这个小服务适合个人、独立开发者或者小团队简单管理自己的服务器或云端服务。
在国内用微信真的很方便，也不用装什么别的 App，目前只能把我们的服务号LetServerRun当作控制台。
右侧有一张使用截图
所以它的原理大概是这样:
您需要关注我们的公众号，把它当作一个Terminal使用，输入help或者帮助查看命令。
然后跟着 快速开始去部署一个 Agent, 或者直接查看文档编写自己的 Agent.
在文档首页有二维码了，这里再贴一次吧，如果关注了请继续后边的步骤。
关注后，输入help或者帮助看看一切是否正常。
给自己发消息是最常用的功能，
在服务号发送 token 命令查看自己的用户 token 。
使用用户 token，您就可以用 API 向公众号发警告消息了：
curl "https://api.letserver.run/message/info?token=YOUR-TOKEN&msg=hello"
PS. 这个 GET 接口是为了调试和轻量使用场景的，在程序中使用的话有更完善的 POST 接口，SDK 也支持主动发消息。
发送通知的服务很多，Server饭 的特色功能是反向用微信控制服务器做简单的事情。 放心，不需要你提供ssh密钥，为了安全，命令能做什么完全由你定义。
下面是反向控制的大概原理：
graph LR
IM(服务号对话) --> c{{Server饭}}
c -- 拉取命令 --> a(Agent)
a -- 返回结果 --> c
c --> IM
通过命令agent add 它的名字增加一个 Agent。
通过status命令，可以看到你加的这个 Agent 在离线状态。一个 Agent 如果三分钟以上没有心跳就会离线。
我们先使用一个
开源的通用 Agent来上手。
它可以帮你在服务器执行特定的命令。后面我们可以根据需求，自己通过 API 或 SDK，集成 Agent 或自己编写。
假设你的服务器是 Debian/Ubuntu ,如果是别的请参考
安装通用Agent
如果您本身就是 root 用户，麻烦去掉所有命令中的 sudo
# 注册仓库
curl -1sLf \
'https://dl.cloudsmith.io/public/hackfan/skadi/setup.deb.sh' \
| sudo -E bash
# 更新
apt update
# 安装
apt install skadi
在安装后，因为还没有 Token，所以并没有自动启动。
我们用 skadi 把之前公众号添加 Agent 得到的 Token 写入配置文件。
你也可以编辑 /etc/skadi/skadi.yml 这个文件自己写入。
# 写入 Token
sudo skadi AGENT-TOKEN
# 启动服务
sudo systemctl start
只有第一次需要配置Token后手动启动服务，服务器重启它是会依靠systemd自己启动的。
在公众号输入 它的名字 help ，在一分钟之内，命令会被Agent拉走并返回结果。
这个官方的通用 Agent 功能由你部署它的服务器上的 /etc/skadi/skadi.yml 这个配置文件定义。
然后你可以顺次输入名字 date,名字 lsroot,名字 free -m,名字 Hi Fool,
去试用，接下来，更改配置文件就可以完成重启服务，查看状态等简单的动作了。
# 调试模式，打开可以看到更多日志，使用 journalctl -u skadi 查看日志
debug: false
# 可以直接填写token到这里，或者用 skadi TOKEN 命令去写入
token:
# shortcuts 将一个单词精确的翻译为一条命令
# short: 你在公众号输入的消息
# dir: 命令的工作目录，可选。有的命令不需要工作目录就不填。
# cmd: 精确的命令。
shortcuts:
- short: date
cmd: "date --rfc-3339=second"
- short: lsroot
dir: /
cmd: ls
# commands 是一个命令白名单，这里列出命令，在公众号使用时可以随意加参数。
# dir: 命令的工作目录，可选。有的命令不需要工作目录就不填。
# prefix: 允许的命令，比如这里允许free，实际使用时可以输入 free -k
commands:
- prefix: free
# templates 是一个模板引擎，可以预留参数，调用时只用输入参数
# name: 调用时接在 Agent 名称后的第一个词
# dir: 命令的工作目录，可选。有的命令不需要工作目录就不填。
# temp: 模板，用的 golang 的模板引擎
# 示例 name:"Hi" temp:"echo I am not %s!"
# 在公众号输入 [Hi 傻瓜] 会收到结果 [I am not 傻瓜!]
templates:
- name: Hi
temp: "echo I am not %s!"
修改完配置文件后，用命令重启服务，它们就生效了。
sudo systemctl restart skadi
如果是控制集群重启之类的，使用我们的 Agent 就够用了。
如果想实现更多的功能，可能需要你自己根据开放接口写一个 Agent 。
甚至直接在服务中集成一个 Agent 实例，就可以把微信当作简单的业务控制台了。
请看各章节详情。
调用用户级别的功能，需要用户 Token
向公众号发送 token 就可以得到自己的用户 Token
现在调用发送消息的 API 就可以往公众号发送消息了
GET https://api.letserver.run/message/info?token=YOUR-TOKEN&msg=hello
用 curl 命令就是这样
curl "https://api.letserver.run/message/info?token=YOUR-TOKEN&msg=hello"
目前有四个消息接口，它们的区别如下：
GET 版本的接口是为了调试和简单的使用的，比如在 CI 脚本中，写起来简单。
POST 版本接口需要把 token 携带在 Authorization Header 中。
并且还支持自定义颜色等，详情参见
接口文档
在接口文档中，除了 User 接口，还有若干 Agent 发消息接口，比如 /agent/message/info
Agent 版本和 User 版本的区别是使用的 Token 不一样。
Agent 版本是为了 Agent 能方便的直接调用，不用再传入 User Token
另外在发送模板消息时，Agent 版本会标注消息来源。
公众号模板消息有每天100条的限制，而纯文本的客服消息，是在你向公众号说话后，会在48小时内有20条发送额度。 每次说话都会重置这个额度。
除了在服务器上调用我们的 API 给公众号发通知，Server饭 更有用的功能是把这个过程反过来， 在公众号输入文字控制服务器的行为，您只要一次配置，以后便有个随身的控制台了。
Agent 是一个概念，它是帮你处理你在公众号中输入的指令的一个程序。
它可以在服务器，在PC，在路由器，在智能设备中。它可以用任何语言写成。 它甚至可以没有实体，只需要在你的服务中调用 API ，就相当于完成了 Agent 的功能。
采取这种 Agent 拉取并执行命令的模式，是为了绝对的安全。你的 Agent 只会执行你允许的动作。
Server饭 的云服务不会主动访问你的服务器，这也带来了内网穿透的功能，你可以任意使用代理。
这里是 Agent API
写一个 Agent 只需要按如下逻辑调用这三个 API 就好了：
我们正在添加各个语言的 SDK，这样写起来会更方便，目前只有 Go 的
欢迎为你喜欢的语言写 SDK
同样的，目前还只有 Go 的例子，后续会在 SDK 完成后添加 python nodejs java php 等语言。
我们会写很多现成的 Agent 供大家使用。目前写好了一个，它可以通过简单配置就启动在 Linux 当中帮你执行指定的命令。
比如重启服务之类的常用需求，使用这个就完全够了。详情见下一节。
如果只是想在服务器上执行简单的命令，使用我们开源的这个通用 Agent 就够了。
它的源代码在： https://github.com/hack-fan/skadi-agent-shell
命令和服务的名字叫 skadi , 和我们的开源项目保持一致。
第一步，增加软件源
curl -1sLf \
'https://dl.cloudsmith.io/public/hackfan/skadi/setup.deb.sh' \
| sudo -E bash
如果你本身用的 root 用户，请去掉命令中的 sudo
第二步，更新源，安装 skadi
apt update
apt install skadi
这里安装就完成了，skadi 在安装完成后并不会立即启动，因为还需要配置 Agent Token， 请参考后续的配置环节。
ps. 如果你对第一步的自动脚本不放心，那么可以用如下步骤手动增加软件源：
apt-get install -y debian-keyring # debian only
apt-get install -y debian-archive-keyring # debian only
apt-get install -y apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/hackfan/skadi/gpg.75A5AACF21FC017E.key' | apt-key add -
curl -1sLf 'https://dl.cloudsmith.io/public/hackfan/skadi/config.deb.txt?distro=ubuntu&codename=xenial' > /etc/apt/sources.list.d/hackfan-skadi.list
apt-get update
注意：你需要更改上述命令中的 ubuntu 和 xenial 为你的发行版和版本。
ps2. 卸载软件源
在使用 apt 卸载 skadi 之后，你也许还想卸载软件源，执行如下命令即可卸载干净：
rm /etc/apt/sources.list.d/hackfan-skadi.list
apt-get clean
rm -rf /var/lib/apt/lists/*
apt-get update
第一步，增加软件源
curl -1sLf \
'https://dl.cloudsmith.io/public/hackfan/skadi/setup.rpm.sh' \
| sudo -E bash
如果你本身用的 root 用户，请去掉命令中的 sudo
第二步，更新源，安装 skadi，如果是 Fedora或SUSE用户，自行替换命令为 dnf/zypper
yum install skadi
这里安装就完成了，skadi 在安装完成后并不会立即启动，因为还需要配置 Agent Token， 请参考后续的配置环节。
ps. 如果你对第一步的自动脚本不放心，那么可以用如下步骤手动增加软件源，这里仅列出 Redhat/CentOS 脚本：
yum install yum-utils pygpgme
rpm --import 'https://dl.cloudsmith.io/public/hackfan/skadi/gpg.75A5AACF21FC017E.key'
curl -1sLf 'https://dl.cloudsmith.io/public/hackfan/skadi/config.rpm.txt?distro=el&codename=7' > /tmp/hackfan-skadi.repo
yum-config-manager --add-repo '/tmp/hackfan-skadi.repo'
yum -q makecache -y --disablerepo='*' --enablerepo='hackfan-skadi'
注意：你需要更改上述命令中的 el 和 7 为你的发行版和版本。
ps2. 卸载软件源
在使用 apt 卸载 skadi 之后，你也许还想卸载软件源，执行如下命令即可卸载干净：
rm /etc/yum.repos.d/hackfan-skadi.repo
rm /etc/yum.repos.d/hackfan-skadi-source.repo
配置文件在 /etc/skadi/skadi.yml
按照注释自行修改即可。
# 调试模式，打开可以看到更多日志，使用 journalctl -u skadi 查看日志
debug: false
# 可以直接填写token到这里，或者用 skadi TOKEN 命令去写入
token:
# shortcuts 将一个单词精确的翻译为一条命令
# short: 你在公众号输入的消息
# dir: 命令的工作目录，可选。有的命令不需要工作目录就不填。
# cmd: 精确的命令。
shortcuts:
- short: date
cmd: "date --rfc-3339=second"
- short: lsroot
dir: /
cmd: ls
# commands 是一个命令白名单，这里列出命令，在公众号使用时可以随意加参数。
# dir: 命令的工作目录，可选。有的命令不需要工作目录就不填。
# prefix: 允许的命令，比如这里允许free，实际使用时可以输入 free -k
commands:
- prefix: free
# templates 是一个模板引擎，可以预留参数，调用时只用输入参数
# name: 调用时接在 Agent 名称后的第一个词
# dir: 命令的工作目录，可选。有的命令不需要工作目录就不填。
# temp: 模板，用的 golang 的模板引擎
# 示例 name:"Hi" temp:"echo I am not %s!"
# 在公众号输入 [Hi 傻瓜] 会收到结果 [I am not 傻瓜!]
templates:
- name: Hi
temp: "echo I am not %s!"
修改完配置文件后，用命令重启服务，它们就生效了。
sudo systemctl restart skadi
重新部署一个 docker stack,
发送xxx 重启就会重启这个 stack
shortcuts:
- short: 重启
# 你的 compose file 的位置
dir: "/root/swarm/"
# docker-compose.yml 是你的 compose file 名称， api 是你的 stack 名称
cmd: "docker stack deploy --prune --with-registry-auth -c docker-compose.yml api"
如果服务器上有多个 stack ，我们可以把配置文件和 stack 做成同名，然后为了使用方便，可以写一个shell，up.sh
docker stack deploy --prune --with-registry-auth -c $1.yml $1
然后用模板功能，最终效果是发送 xxx up api 就会重启 api 这个stack
templates:
- name: up
temp: "sh up.sh %s"
dir: "/root/swarm"
很多业务场景都要用到延迟队列：
类似的还有很多，不一一列举了。
因为叫队列，所以如果项目用了某种队列，第一反应就是去看这种队列是不是支持延迟队列。
很不幸，各家队列和云服务商提供的队列，都对延迟队列支持的不怎么好。只有 RabbitMQ 稍微好一点。
为什么会这样呢？因为延迟队列和传统的队列压根是两种东西。想兼容当然不容易了。 传统的队列一般都是先进先出，可以是生产消费模式或者广播订阅模式。更侧重于性能、可靠性、顺序性等方面的改善。
但是延迟队列实际上是一种持久存储的计划任务，它更应该和传统的队列结合使用。Job存储在一个安全可靠的地方，到时间了拿出来放某个队列供消费。
这个时候我们开箱即用的接口就很方便了。
我已经在 坚橙艺术 中实际使用了一段时间，分享给大家。
15天后订单完成 123。订单完成的函数。订单完成 123。通过引用官方的 Github Action ，可以方便的在你的 Action 最后通过 Server饭 反馈执行结果。
Github 市场： https://github.com/marketplace/actions/serverfan-notifier
把
LetServerRun置顶。在手机端和 Windows 桌面版，都可以很方便的进入从而下达指令。 在 Mac 版里，会被折叠进订阅号，想用的话只能搜索 lets 然后就能搜出来。
输入
poster指令，获得分享海报。别人通过你的海报关注后，会为你们双方各增加一个 Agent 配额哦。
你可以利用 Agent 上线离线自动产生的通知，做很多有趣的事情。比如只要服务中集成了 Agent，什么都不做相当于在监控它了。
HTTP API 文档在顶端目录里边。 点击这里也可以直接访问。
API 分为 User 系列和 Agent 系列。
然后为了方便大家使用，会陆续推出各个语言的 SDK，会尽量都写成0依赖的。
这个章节就是各 SDK 的简单说明。
新增功能
改动
skadi-agent-shell 增加了 arm64 版本。新增功能
改动
skadi-agent-shell 检查任务间隔从1分钟降低到10秒。skadigo 默认检查任务间隔从1分钟降低到30秒。改动
修复
改动
skadigo 支持传入 Debug 参数，此模式下不发送任何网络请求，没有 token 也不会报错。新增功能
/agent/job/delayed 接口，让 Agent 可以给自己发延迟任务了。skadigo 同步增加了目前所有支持的接口。新增功能
/agent/message/auto 接口，让 Agent 也能使用自动适配发送方式的消息。/agent/job/add POST 接口，让 Agent 可以给别的 Agent 发送任务了。改动
/agent/message/新增功能
/message/auto 系列接口，在可以用微信文本消息的时候用文本消息，如果不行就用模版消息。/job/add 接口，可以调用 API 向 Agent 发 Job 了， CI 利器。新增功能
改动
新增功能
改动
把这个版本当作初始版本吧，目前的功能有：