feat(docker): Add QR code login support and Docker environment detection

- Add Docker environment detection utility to check for /.dockerenv file
- Implement QR code generation and display for login in Docker containers
- Add qrcode and @types/qrcode dependencies to package.json
- Generate QR code as both terminal output and PNG file for Docker login flow
- Update Docker build scripts and Dockerfiles to create /.dockerenv marker
- Configure Vite alias for qrcode server module
- Display login QR code URL for browser-based scanning when running in Docker
- Trigger QR code display only once during initial login check in Docker environment

Author: linyuchen

docker/Dockerfile.local

@@ -35,4 +35,6 @@ COPY --from=builder /app/dist .
 COPY docker/startup.sh /startup.sh
 RUN chmod +x /startup.sh
 
+RUN touch /.dockerenv
+
 ENTRYPOINT ["/startup.sh"]

docker/debug-build-amd64.ps1

@@ -1 +1 @@
-docker buildx build -f docker/debug.Dockerfile --progress=plain --platform linux/amd64 -t linyuchen/llonebot .
+docker buildx build -f docker/debug.Dockerfile --progress=plain --platform linux/amd64 -t linyuchen/llbot .

docker/debug.Dockerfile

@@ -21,6 +21,8 @@ COPY docker/startup.sh /startup.sh
 
 RUN chmod +x /startup.sh
 
+RUN touch /.dockerenv
+
 #RUN wget https://github.com/LLOneBot/LLOneBot/releases/download/v$LLONEBOT_VERSION/LLOneBot.zip -O /app/llonebot.zip
 
 COPY /dist /app/llonebot

package.json

@@ -34,6 +34,7 @@
     "minato": "^3.7.0",
     "multer": "^2.0.2",
     "nodemailer": "^8.0.1",
+    "qrcode": "^1.5.4",
     "silk-wasm": "^3.7.1",
     "ws": "^8.19.0",
     "zod": "^4.3.6"
@@ -45,6 +46,7 @@
     "@types/multer": "^2.0.0",
     "@types/node": "^24.10.11",
     "@types/nodemailer": "^7.0.10",
+    "@types/qrcode": "^1.5.6",
     "@types/ws": "^8.18.1",
     "supports-color": "^10.2.2",
     "ts-case-convert": "^2.1.0",

src/common/utils/environment.ts

@@ -0,0 +1,9 @@
+import { existsSync } from "fs"
+
+export function isDockerEnvironment(): boolean {
+    try {
+        return existsSync('/.dockerenv')
+    } catch {
+        return false
+    }
+}

src/main/main.ts

@@ -1,4 +1,6 @@
 import path from 'node:path'
+import { writeFile } from 'node:fs/promises'
+import QRCode from 'qrcode'
 
 // 全局异常处理，防止未捕获的异常导致程序崩溃
 process.on('uncaughtException', (err) => {
@@ -42,6 +44,7 @@ import { pmhq } from '@/ntqqapi/native/pmhq'
 import { sleep } from '@/common/utils'
 import EmailNotificationService from '@/common/emailNotification'
 import { EmailConfig } from '@/common/emailConfig'
+import { isDockerEnvironment } from '@/common/utils/environment'
 
 declare module 'cordis' {
   interface Events {
@@ -51,6 +54,8 @@ declare module 'cordis' {
 }
 
 
+
+
 async function onLoad() {
   if (!existsSync(DATA_DIR)) {
     mkdirSync(DATA_DIR, { recursive: true })
@@ -107,6 +112,33 @@ async function onLoad() {
     ctx.plugin(EmailNotificationService)
   }
 
+  const isDocker = isDockerEnvironment()
+  let qrCodeTriggered = false
+
+  const printLoginQrCode = async () => {
+    try {
+      const data = await ctx.ntLoginApi.getLoginQrCode()
+
+      const qrText = await QRCode.toString(data.qrcodeUrl, { type: 'terminal', small: true })
+      console.log('\n========== 请使用手机QQ扫描二维码登录 ==========')
+      console.log(qrText)
+      console.log('================================================\n')
+
+      const base64Data = data.pngBase64QrcodeData.replace(/^data:image\/png;base64,/, '')
+      const qrFilePath = path.join(TEMP_DIR, 'login-qrcode.png')
+      if (!existsSync(TEMP_DIR)) {
+        mkdirSync(TEMP_DIR, { recursive: true })
+      }
+      await writeFile(qrFilePath, Buffer.from(base64Data, 'base64'))
+      ctx.logger.info(`二维码文件已保存: ${qrFilePath}`)
+
+      const qrWebUrl = `https://api.2dcode.biz/v1/create-qr-code?data=${encodeURIComponent(data.qrcodeUrl)}`
+      ctx.logger.info(`或浏览器打开二维码网址: ${qrWebUrl}`)
+    } catch (e) {
+      ctx.logger.warn('获取登录二维码失败', e)
+    }
+  }
+
   const checkLogin = async () => {
     let pmhqSelfInfo = { ...selfInfo }
     try {
@@ -117,6 +149,10 @@ async function onLoad() {
       return
     }
     if (!pmhqSelfInfo.online) {
+      if (isDocker && !qrCodeTriggered) {
+        qrCodeTriggered = true
+        printLoginQrCode()
+      }
       setTimeout(checkLogin, 1000)
       return
     }

vite.config.ts

@@ -81,8 +81,9 @@ export default defineConfig({
   },
   resolve: {
     alias: {
-      '@': '/src', // 可选：配置路径别名
+      '@': '/src',
       'supports-color': 'node_modules/supports-color/index.js',
+      'qrcode': 'node_modules/qrcode/lib/server.js',
     },
   },
 })