ironsbot

ironsbot

Docker app from IronsBot Unraid's Repository

Overview

IronsBot custom image for Seer information queries, NoneBot2/OneBot v11 messaging, and personal Unraid-friendly plugins. Version tags use latest plus project-version.revision tags and exact sha tags; behavior config is file-based through APP_CONFIG_PATH, with environment variables kept for secrets, credentials, and deployment runtime only.

Readme

View on GitHub

IronsBot Unraid Templates

This repository only contains Unraid Community Applications metadata and Docker templates for IronsBot.

Main project:

Docker image:

  • murmansk5000/ironsbot:latest

Template:

  • templates/ironsbot.xml

Runtime behavior is configured by mounting a directory to /config and setting APP_CONFIG_PATH=/config/ironsbot.toml. See the main project README for the full configuration guide.

Install Ironsbot on Unraid in a few clicks.

Find Ironsbot in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Ironsbot Review the template variables and paths Click Install
Explore Unraid OS

Requirements

Requires a OneBot v11 client such as NapCat. Configure the client reverse WebSocket to ws://UNRAID_SERVER_IP:8085/onebot/v11/ws, or use ws://ironsbot:8080/onebot/v11/ws when both containers share a Docker network. Changelog/version check: latest remains available; fixed builds are tagged as project-version.revision plus sha-xxxxxxx. See the Docker Hub README / ReadMe link for full notes.

Categories

Tools > Utilities

Download Statistics

3,528
Total Downloads

Related apps

Explore more like this

Explore all
Utilities apps

Links

Projectgithub.comSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
murmansk5000/ironsbot:latest
Registry
https://hub.docker.com/r/murmansk5000/ironsbot
Last Updated2026-06-13
First Seen2026-06-17

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebSocket PortPorttcp

主机端口映射到容器内 8080，NapCat/OneBot 反向 WebSocket 连接这个端口。

Target
8080
Default
8085
Value
8085
IronsBot DataPathrw

持久化数据目录，用来保存插件缓存、B站 Cookie、SQLite 数据库和本地缓存文件。

Target
/app/data
Default
/mnt/user/appdata/ironsbot/data
Value
/mnt/user/appdata/ironsbot/data
IronsBot ConfigPathro

只读挂载配置目录，目录内放 ironsbot.toml。可从仓库的 config.prod.toml 或 config.example.toml 复制后修改。

Target
/config
Default
/mnt/user/appdata/ironsbot/config
Value
/mnt/user/appdata/ironsbot/config
EnvironmentVariable

NoneBot 运行环境名，生产环境通常填 prod。

Target
ENVIRONMENT
Default
prod
Value
prod
DriverVariable

NoneBot 驱动配置，保持 ~fastapi+~httpx 即可支持 OneBot 反向 WebSocket 和 HTTP 请求。

Target
DRIVER
Default
~fastapi+~httpx
Value
~fastapi+~httpx
HostVariable

容器内监听地址，Docker/Unraid 中建议 0.0.0.0。

Target
HOST
Default
0.0.0.0
Value
0.0.0.0
PortVariable

容器内监听端口，需与端口映射的容器端口一致。

Target
PORT
Default
8080
Value
8080
Log LevelVariable

日志级别，可填 TRACE、DEBUG、INFO、WARNING 或 ERROR。

Target
LOG_LEVEL
Default
INFO
Value
INFO
Command StartVariable

命令前缀列表，包含空字符串时可直接发送口令。

Target
COMMAND_START
Default
["/", ""]
Value
["/", ""]
App Config PathVariable

行为配置 TOML 文件路径。Unraid 中保持 /config/ironsbot.toml，并在上方 Config 目录里放置该文件。

Target
APP_CONFIG_PATH
Default
/config/ironsbot.toml
Value
/config/ironsbot.toml
OneBot Access TokenVariable

OneBot 连接令牌，必须和 NapCat 等 OneBot 客户端的 access_token 一致。

Target
ONEBOT_ACCESS_TOKEN
SuperusersVariable

超级管理员 QQ 列表，必填。示例：[123456789] 或 ["123456789"]。

Target
SUPERUSERS
Default
[]
Value
[]
Headless Seer User IDVariable

可选。米米号账号；只有需要无头登录/自动化赛尔号操作时填写，不使用时留空。

Target
HEADLESS_SEER_USER_ID
Headless Seer PasswordVariable

可选。米米号密码的 MD5 值；和米米号账号配套使用，不使用时留空。

Target
HEADLESS_SEER_PASSWORD
AI Chat API KeyVariable

AI 聊天的 API Key，例如 DeepSeek Key；这是密钥，不要提交到 Git。

Target
AI_KEY
SendPic CNB TokenVariable

可选。custom_sendpic 使用 CNB 后端时的访问令牌；仓库名等行为配置写在 /config/ironsbot.toml。

Target
SENDPIC_CNB_TOKEN