iranee/fnos-hermes-agent

> 官方文档入口：<https://developer.fnnas.com/docs/guide/>

> 参考：<https://developer.fnnas.com/docs/cli/fnpack/>、<https://developer.fnnas.com/docs/core-concepts/framework/>

**字段总表**（来源 <https://developer.fnnas.com/docs/core-concepts/manifest/>）：

source                = thirdparty maintainer            = "Nous Research" maintainer_url        = https://github.com/NousResearch/hermes-agent

maintainer            = "Nous Research" maintainer_url        = https://github.com/NousResearch/hermes-agent distributor           = bbis

maintainer_url        = https://github.com/NousResearch/hermes-agent

distributor           = bbis distributor_url       = https://github.com/iranee/fnos-hermes-agent desktop_uidir         = ui

distributor_url       = https://github.com/iranee/fnos-hermes-agent

安装后 fnOS 在 `/var/apps/{appname}` 下创建如下结构（来源 <https://developer.fnnas.com/docs/core-concepts/framework/>）：

> 参考：<https://developer.fnnas.com/docs/core-concepts/framework/>

> 来源：<https://developer.fnnas.com/docs/core-concepts/environment-variables/>

> 来源：<https://developer.fnnas.com/docs/core-concepts/resource/>

> 来源：<https://developer.fnnas.com/docs/core-concepts/app-entry/>、<https://developer.fnnas.com/docs/core-concepts/gateway-registration/>

| WebSocket | ✅（独立端口） | ❌ | ✅ | | NAS 登录态 | 无关 | CGI 前校验 | 转发前校验+用户 Header | | 路径 | `http://NAS:port/` | `/cgi/ThirdParty/{appname}/` | `/app/{appname}` |

| 路径 | `http://NAS:port/` | `/cgi/ThirdParty/{appname}/` | `/app/{appname}` |

> 来源：<https://developer.fnnas.com/docs/core-concepts/wizard/>

> 来源：<https://developer.fnnas.com/docs/core-concepts/privilege/>

> 来源：<https://developer.fnnas.com/docs/cli/fnpack/>

# 示例：Linux x86 curl -L https://developer.fnnas.com/downloads/fnpack-1.2.3-linux-amd64 -o fnpack

curl -L https://developer.fnnas.com/downloads/fnpack-1.2.3-linux-amd64 -o fnpack

chmod +x fnpack && sudo mv fnpack /usr/local/bin/

> 来源：<https://developer.fnnas.com/docs/core-concepts/dependency/>、<https://developer.fnnas.com/docs/core-concepts/runtime/>、<https://developer.fnnas.com/docs/core-concepts/middleware/>

超级管理员账户：默认可 sudo docker

sudo docker logs <container>

sudo docker inspect <container> | grep -A3 '"ExitCode"'

sudo docker inspect <container> | grep '"IPAddress"'

sudo docker exec -it <container> ping 8.8.8.8

sudo docker system df -v           # 找出占用大户

sudo docker image prune -f         # 清理悬空镜像

sudo docker container prune -f     # 清理停止容器

sudo docker info | grep "Docker Root Dir"

secret_b64   = base64.b64encode(unpad(aes_cipher.decrypt(base64.b64decode(secret)), AES.block_size)).decode()

secret_bytes = base64.b64decode(secret_b64)  # HMAC 签名密钥原始字节

'Trim-Mtim': str(int(os.path.getmtime(local_path))), } r = requests.post(f'https://<NAS_HOST>:5667/upload', headers=headers,

} r = requests.post(f'https://<NAS_HOST>:5667/upload', headers=headers,     files={"trim-upload-file": (filename, open(local_path,'rb'), "application/octet-stream")}, verify=False)

r = requests.post(f'https://<NAS_HOST>:5667/upload', headers=headers,

**禁止** CLI `iptables -F` 清空规则。紧急封锁 IP：`sudo iptables -A INPUT -s <IP> -j DROP`（临时，重启失效）。

sudo docker system df -v 2>/dev/null                    # Docker 占用

sudo docker logs --tail 50 <container>                    # 退出日志

sudo docker inspect <container> | grep -A3 '"ExitCode"'   # 退出码

sudo docker exec -it <container> ping 8.8.8.8

sudo docker exec -it <container> nslookup baidu.com

ss -tlnp | grep 5667                       # 端口监听 curl -sk https://<NAS_IP>:5667/ | head -20  # HTTPS 连通

curl -sk https://<NAS_IP>:5667/ | head -20  # HTTPS 连通

rm /vol1/@appdata/<appname>/config/config.yaml

GitHub: https://github.com/hbestm/openlist-mcp-server

git clone https://github.com/hbestm/openlist-mcp-server.git

✅ [qr](https://example.com/target-url)      → 扫码打开链接

https://example.com/share/abc123

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

rm /vol1/1000/alice/文件.txt                               # 永久删除，无法恢复（未经确认禁止）

**原因**：HTTP vs HTTPS 混淆   **排查**：`curl -vk http://localhost:9119/`（Dashboard 默认 HTTP）

**排查**：`curl -vk http://localhost:9119/`（Dashboard 默认 HTTP）

**解决**：确保浏览器访问 `http://` 而不是 `https://`

ss -tlnp | grep 5667        # WEB UI（HTTPS） ss -tlnp | grep 8642        # Gateway API curl -sk https://localhost:5667/

ss -tlnp | grep 8642        # Gateway API curl -sk https://localhost:5667/ curl -sk http://localhost:8642/v1

curl -sk https://localhost:5667/

curl -sk http://localhost:8642/v1

[Credential-related source omitted]

#### file rm <path>

trim-cli --host <host> --port <port> file rm /vol2/1106/old-dir --yes

trim-cli --host <host> --port <port> download add-uri 'magnet:?xt=urn:btih:...' /vol1/downloads trim-cli --host <host> --port <port> download add-uri 'https://example.com/file.zip' /vol1/downloads

trim-cli --host <host> --port <port> download add-uri 'https://example.com/file.zip' /vol1/downloads

#### download rm <id...>

trim-cli --host <host> --port <port> download rm 42 43

Binary executable

- 控制命令 `download pause|resume|retry|rm <id...>` 只改变已存在任务，命令不会自动补路径

./scripts/trim-cli download info <id> ./scripts/trim-cli download files <id> ./scripts/trim-cli download add-uri https://example.com/file.iso /vol1/download

./scripts/trim-cli download files <id> ./scripts/trim-cli download add-uri https://example.com/file.iso /vol1/download ./scripts/trim-cli download add-path /vol1/source.iso /vol1/download

./scripts/trim-cli download add-uri https://example.com/file.iso /vol1/download

./scripts/trim-cli download rm <id...>

trim-cli docker image rm <imageRef> [--force] [--yes]

trim-cli docker container rm <containerId> [--force] [--yes]

trim-cli download rm <id...>

trim-cli file rm /vol{v}/... --yes

./scripts/trim-cli file rm /vol1/1000/tmp-upload/demo.txt --yes

./scripts/trim-cli file rm /vol1/1000/tmp-upload --yes

#!/bin/sh

Executable file

Executable file