ironsbot

Docker app from Murmansk5000's Repository

Overview

IronsBot custom image for Seer information queries, NoneBot2/OneBot v11 messaging, and personal Unraid-friendly plugins. Version tags use latest plus upstream-version.fork-revision tags and exact sha tags; recent changes include AI chat, persistent Bilibili login data, startup notices, scheduled messages, and team group shortcuts.

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 upstream-version.fork-revision plus sha-xxxxxxx. See the Docker Hub README / ReadMe link for full notes.

Runtime arguments

Network: bridge
Shell: sh
Privileged: false

Template configuration

WebSocket PortPorttcp

Host port mapped to IronsBot internal port 8080.

Target: 8080
Default: 8085
Value: 8085

IronsBot DataPathrw

Persistent data directory for plugin caches, Bilibili cookies, and local database cache files.

Target: /app/data
Default: /mnt/user/appdata/ironsbot/data
Value: /mnt/user/appdata/ironsbot/data

EnvironmentVariable

NoneBot environment name.

Target: ENVIRONMENT
Default: prod
Value: prod

DriverVariable

NoneBot driver setting.

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

HostVariable

IronsBot listen host inside container.

Target: HOST
Default: 0.0.0.0
Value: 0.0.0.0

PortVariable

IronsBot listen port inside container.

Target: PORT
Default: 8080
Value: 8080

Log LevelVariable

TRACE / DEBUG / INFO / WARNING / ERROR.

Target: LOG_LEVEL
Default: INFO
Value: INFO

Command StartVariable

NoneBot command prefixes.

Target: COMMAND_START
Default: ["/",""]
Value: ["/",""]

DB Sync On StartupVariable

Run remote database sync during startup. Leave false to avoid slow startup; cached data loads from /app/data. Superusers can send 更新数据 or 数据更新 manually.

Target: DB_SYNC_ON_STARTUP
Default: false
Value: false

DB Sync Interval EnabledVariable

Enable scheduled database sync jobs after startup. Enabled by default; set false only if you want manual-only updates.

Target: DB_SYNC_INTERVAL_ENABLED
Default: true
Value: true

OneBot Access TokenVariable

Access token used by NapCat or another OneBot v11 client to connect to IronsBot.

Target: ONEBOT_ACCESS_TOKEN

SuperusersVariable

NoneBot superuser QQ list, for example ["123456789"].

Target: SUPERUSERS
Default: []
Value: []

SeerAPI Sync URLVariable

Remote SeerAPI SQLite database URL.

Target: SEERAPI_SYNC_URL
Default: https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite
Value: https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite

SeerAPI Fingerprint URLVariable

Remote SeerAPI SHA256 fingerprint URL.

Target: SEERAPI_FINGERPRINT_URL
Default: https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite.sha256
Value: https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite.sha256

SeerAPI Sync IntervalVariable

SeerAPI sync interval in minutes.

Target: SEERAPI_SYNC_INTERVAL_MINUTES
Default: 60
Value: 60

SeerAPI Local PathVariable

Local cache/fallback SeerAPI database path. Keep /app/data mounted for persistence.

Target: SEERAPI_LOCAL_PATH
Default: data/seerapi-data.sqlite
Value: data/seerapi-data.sqlite

Alias Sync URLVariable

Remote alias SQLite database URL.

Target: ALIAS_SYNC_URL
Default: https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite
Value: https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite

Alias Fingerprint URLVariable

Remote alias SHA256 fingerprint URL.

Target: ALIAS_FINGERPRINT_URL
Default: https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite.sha256
Value: https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite.sha256

Alias Sync IntervalVariable

Alias database sync interval in minutes.

Target: ALIAS_SYNC_INTERVAL_MINUTES
Default: 65
Value: 65

Alias Local PathVariable

Local cache/fallback alias database path. Keep /app/data mounted for persistence.

Target: ALIAS_LOCAL_PATH
Default: data/aliases-data.sqlite
Value: data/aliases-data.sqlite

Render Cache DirVariable

Rendered image cache directory.

Target: RENDER_CACHE_DIR
Default: render_cache
Value: render_cache

Render Cache Max MBVariable

Rendered image cache max size in MB.

Target: RENDER_CACHE_MAX_SIZE_MB
Default: 200
Value: 200

Headless Seer User IDVariable

Optional Seer user ID / Mimi number for features that require login.

Target: HEADLESS_SEER_USER_ID

Headless Seer PasswordVariable

Optional MD5 password for the headless Seer login client.

Target: HEADLESS_SEER_PASSWORD

Headless Reconnect RetriesVariable

Headless client reconnect retry count.

Target: HEADLESS_SEER_RECONNECT_RETRIES
Default: 3
Value: 3

Meeting Reply NumberVariable

Tencent Meeting number, for example 1234567890 or 123-456-7890. The meeting URL is generated automatically.

Target: MEETING_REPLY_NUMBER

Meeting Reply TemplateVariable

Meeting reply template. Variables: {meeting_number}, {meeting_digits}, {meeting_url}.

Target: MEETING_REPLY_TEMPLATE
Default: Tencent Meeting Meeting Number: {meeting_number} Join Link: {meeting_url}
Value: Tencent Meeting Meeting Number: {meeting_number} Join Link: {meeting_url}

Meeting Reply GroupsVariable

QQ groups allowed to use meeting reply, for example [123456789].

Target: MEETING_REPLY_GROUPS
Default: []
Value: []

Meeting Reply UsersVariable

QQ users allowed to use meeting reply in private chat, for example [123456789].

Target: MEETING_REPLY_USERS
Default: []
Value: []

Event Link Reply GroupsVariable

QQ groups allowed to query event links.

Target: EVENT_LINK_REPLY_GROUPS
Default: []
Value: []

Event Link Reply UsersVariable

QQ users allowed to query event links in private chat.

Target: EVENT_LINK_REPLY_USERS
Default: []
Value: []

Event Link Send GroupsVariable

QQ groups receiving scheduled event links.

Target: EVENT_LINK_SEND_GROUPS
Default: []
Value: []

Event Link Send UsersVariable

QQ users receiving scheduled event links in private chat.

Target: EVENT_LINK_SEND_USERS
Default: []
Value: []

Event Link Send HourVariable

Scheduled event link send hour.

Target: EVENT_LINK_SEND_HOUR
Default: 23
Value: 23

Event Link Send MinuteVariable

Scheduled event link send minute.

Target: EVENT_LINK_SEND_MINUTE
Default: 0
Value: 0

Scheduled Private MessagesVariable

JSON list of private message tasks. Example: [{"id":"morning","user_ids":[123456789],"hour":8,"minute":30,"message":"hello"}].

Target: SCHEDULED_PRIVATE_MESSAGES
Default: []
Value: []

Team Group Shortcut GroupsVariable

QQ team groups where the shortcut command should trigger team queries. Keep private group IDs here instead of committing them to Git.

Target: TEAM_SHORTCUT_GROUP_IDS
Default: []
Value: []

Team Group Shortcut Team IDsVariable

Team IDs queried for the team group shortcut command, for example [1234567,7654321]. Keep private values out of Git.

Target: TEAM_SHORTCUT_TEAM_IDS
Default: []
Value: []

Team Group Shortcut CommandsVariable

Exact team group shortcut commands that trigger the configured team queries.

Target: TEAM_SHORTCUT_COMMANDS
Default: ["战队"]
Value: ["战队"]

Startup Notice EnabledVariable

Send a private startup notice after the bot connects. SUPERUSERS receive it automatically.

Target: STARTUP_NOTICE_ENABLED
Default: true
Value: true

Startup Notice UsersVariable

Extra QQ users receiving startup notices. SUPERUSERS are included automatically.

Target: STARTUP_NOTICE_USERS
Default: []
Value: []

Startup Notice MessageVariable

Private message sent when IronsBot starts and connects.

Target: STARTUP_NOTICE_MESSAGE
Default: Bot started.
Value: Bot started.

Startup Notice DelayVariable

Seconds to wait after bot connection before sending the startup notice.

Target: STARTUP_NOTICE_DELAY_SECONDS
Default: 3
Value: 3

AI Chat API KeyVariable

DeepSeek API key. Keep this private.

Target: AI_CHAT_API_KEY

AI Chat Base URLVariable

OpenAI-compatible API base URL. For relay/NewAPI services, usually use the /v1 endpoint, for example https://example.com/v1.

Target: AI_CHAT_BASE_URL
Default: https://api.deepseek.com
Value: https://api.deepseek.com

AI Chat ModelVariable

Model name used by the configured AI chat provider.

Target: AI_CHAT_MODEL
Default: deepseek-v4-flash
Value: deepseek-v4-flash

AI Chat System PromptVariable

System prompt sent to the AI model.

Target: AI_CHAT_SYSTEM_PROMPT
Default: You are IronsBot, a QQ group bot for Seer information queries. Help users discuss Seer pets, skills, abilities, stats, type matchups, events, and bot usage. You may chat naturally, but keep replies concise, friendly, and honest. If unsure, say so instead of inventing facts.
Value: You are IronsBot, a QQ group bot for Seer information queries. Help users discuss Seer pets, skills, abilities, stats, type matchups, events, and bot usage. You may chat naturally, but keep replies concise, friendly, and honest. If unsure, say so instead of inventing facts.

AI Chat Allowed GroupsVariable

Optional QQ group whitelist. Empty means no group restriction. Group chats still require mentioning the bot.

Target: AI_CHAT_ALLOWED_GROUP_IDS
Default: []
Value: []

AI Chat Allowed UsersVariable

QQ users allowed to use AI chat. Group chats require mentioning the bot.

Target: AI_CHAT_ALLOWED_USER_IDS
Default: []
Value: []

AI Chat Admin UsersVariable

Extra AI chat admins. SUPERUSERS are allowed automatically.

Target: AI_CHAT_ADMIN_UIDS
Default: []
Value: []

AI Chat Allow Group OwnerVariable

Allow group owners to use AI chat by mentioning the bot.

Target: AI_CHAT_ALLOW_GROUP_OWNER
Default: true
Value: true

AI Chat History TurnsVariable

Conversation history turns kept per user.

Target: AI_CHAT_HISTORY_TURNS
Default: 6
Value: 6

AI Chat Timeout SecondsVariable

AI API request timeout in seconds.

Target: AI_CHAT_TIMEOUT_SECONDS
Default: 45
Value: 45

AI Chat Max TokensVariable

Maximum generated tokens per AI reply.

Target: AI_CHAT_MAX_TOKENS
Default: 800
Value: 800

AI Chat TemperatureVariable

AI sampling temperature from 0 to 2.

Target: AI_CHAT_TEMPERATURE
Default: 0.7
Value: 0.7

AI Chat Thinking EnabledVariable

Enable DeepSeek thinking mode. Disabled is usually faster for casual chat.

Target: AI_CHAT_THINKING_ENABLED
Default: false
Value: false

AI Chat Waiting NoticeVariable

Send a short waiting message before calling the AI API.

Target: AI_CHAT_SEND_WAITING_NOTICE
Default: false
Value: false

AI Chat Max Reply CharsVariable

Maximum characters sent back to QQ before truncation.

Target: AI_CHAT_MAX_REPLY_CHARS
Default: 1500
Value: 1500

Bilibili Monitor UIDVariable

Bilibili UID to monitor.

Target: BILIBILI_MONITOR_UID
Default: 1310714247
Value: 1310714247

Bilibili Data DirectoryVariable

Directory for Bilibili cookie and dynamic timestamp cache. Keep /app/data mounted for persistence.

Target: BILIBILI_MONITOR_DATA_DIR
Default: data/bilibili_monitor
Value: data/bilibili_monitor

Bilibili Check IntervalVariable

Bilibili dynamic check interval in minutes.

Target: BILIBILI_MONITOR_CHECK_INTERVAL_MINUTES
Default: 5
Value: 5

Bilibili Sleep Start HourVariable

Low-frequency check start hour.

Target: BILIBILI_MONITOR_SLEEP_START_HOUR
Default: 23
Value: 23

Bilibili Sleep End HourVariable

Low-frequency check end hour.

Target: BILIBILI_MONITOR_SLEEP_END_HOUR
Default: 7
Value: 7

Bilibili Sleep IntervalVariable

Low-frequency check interval in minutes.

Target: BILIBILI_MONITOR_SLEEP_INTERVAL_MINUTES
Default: 30
Value: 30

Bilibili Target GroupsVariable

QQ groups receiving Bilibili dynamic updates.

Target: BILIBILI_MONITOR_TARGET_GROUP_IDS
Default: []
Value: []

Bilibili Target UsersVariable

QQ users receiving Bilibili dynamic updates in private chat.

Target: BILIBILI_MONITOR_TARGET_USER_IDS
Default: []
Value: []

Bilibili Admin UsersVariable

QQ users allowed to run Bilibili monitor admin commands.

Target: BILIBILI_MONITOR_ADMIN_UIDS
Default: []
Value: []

Links

Template Support Docker Hub Project

Details

Repository

murmansk5000/ironsbot:latest

Registry

https://hub.docker.com/r/murmansk5000/ironsbot

Last Updated2026-05-31

First Seen2026-05-31

Run Ironsbot on Unraid.

Ironsbot is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS