ghcr.io/wttwins/wrong-notebook:armv7-ci-test5-amd64 Docker...

热门搜索:

ghcr.iolinux/amd64armv7-ci-test5-amd64大小: 未知更新于 2026年6月6日

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

Smart Wrong Notebook（智能错题本）

一个基于 AI 的智能错题管理系统，帮助学生高效整理、分析和复习错题。

✨ 主要功能

🤖 AI 智能分析：自动识别题目内容，生成解析、知识点标签和同类练习题。
⚙️ 灵活的 AI 配置：支持 Google Gemini 和 OpenAI（及兼容接口）两种 AI 提供商，可直接在网页设置中动态切换和配置。
📚 多错题本管理：支持按科目（如数学、物理、英语）创建和管理多个错题本。
🏷️ 智能标签系统：自动提取知识点标签，支持自定义标签管理。
🔍 多维度筛选：支持按掌握状态、时间范围、知识点标签、年级学期、试卷等级等多种条件筛选错题。
🖨️ 灵活导出打印：一键导出筛选后的错题，支持自定义打印内容（答案/解析/知识点）和图片缩放比例，可直接打印或保存为 PDF。
📝 智能练习：基于错题生成相似的练习题，巩固薄弱环节。
📊 数据统计：可视化展示错题掌握情况和学习进度。
🔐 用户管理：支持多用户注册、登录，数据安全隔离。
🛡️ 管理员后台：提供用户管理功能，可禁用/启用用户、删除违规用户。

📸 屏幕截图功能（HTTPS 设置）

本应用的屏幕截图功能依赖浏览器的安全上下文（HTTPS）。在 Docker 或局域网环境中使用时，请参考 HTTPS 配置指南启用内置 HTTPS 支持。

📱 PWA 支持（添加到主屏幕）

本项目支持 PWA（Progressive Web App），您可以将应用添加到手机主屏幕，获得原生应用般的使用体验。

功能特性：

🚀 快速启动：点击主屏幕图标直接打开，无需输入网址。
📱 沉浸体验：全屏运行，无浏览器地址栏干扰。
🎨 原色适配：应用图标和启动画面适配系统主题。

使用方法：

iPhone / iPad（Safari）：点击底部分享按钮 -> 选择 "添加到主屏幕"。
Android（Chrome）：点击右上角菜单 -> 选择 "添加到主屏幕" 或 "安装应用"。

🛠️ 技术栈

框架: Next.js 16（App Router）
UI 库: React 19
数据库: SQLite（via Prisma）
样式: Tailwind CSS v4 + Shadcn UI
AI: Google Gemini API / OpenAI API / Azure OpenAI
认证: NextAuth.js

🚀 快速开始

方式一：使用 Docker 部署

1. 启动服务

您可以选择 直接使用命令（适合快速测试）或 Docker Compose（适合长期运行）。

选项 A：直接使用 Docker 命令

docker run -d --name wrong-notebook \
-e NEXTAUTH_SECRET="your_secret_key" \
-p 3000:3000 \
-v $(pwd)/data:/app/data \
-v $(pwd)/config:/app/config \
ghcr.io/wttwins/wrong-notebook

选项 B：使用 Docker Compose（推荐）

使用 docker-compose.yml 文件进行管理。

下载配置文件：

curl -o docker-compose.yml https://raw.githubusercontent.com/wttwins/wrong-notebook/refs/heads/main/docker-compose.yml

启动服务：

docker-compose up -d

查看日志：

docker-compose logs -f

停止服务：

docker-compose down

方式二：本地源码运行

1. 克隆仓库

git clone https://github.com/wttwins/wrong-notebook.git
cd wrong-notebook

2. 环境准备

确保已安装 Node.js（v18+）和 npm。

3. 安装依赖

npm install

4. 配置环境变量

复制 .env.example 为 .env 并填入必要的配置：

cp .env.example .env

环境变量	描述	默认值	说明
DATABASE_URL	数据库连接地址	file:./dev.db	SQLite 数据库路径
NEXTAUTH_SECRET	Auth 密钥	无	用于加密 Session，生产环境建议设置，可以使用 `openssl rand -base64 32` 生成随机字符串作为密钥
NEXTAUTH_URL	访问地址	[***]	部署后的访问地址
AUTH_TRUST_HOST	信任主机头	true	设置为 true 时自动推断 URL，适合 Docker/PaaS
LOG_LEVEL	日志级别	debug（开发）/ info（生产）	可选值：trace, debug, info, warn, error, fatal
HTTP_PROXY	HTTP 代理	无	设置 HTTP 代理
HTTPS_PROXY	HTTPS 代理	无	设置 HTTPS 代理

AI 配置

环境变量	描述	默认值	说明
AI_PROVIDER	AI 提供商	gemini	可选 gemini、openai 或 azure

Gemini 配置

环境变量	描述	默认值	说明
GOOGLE_API_KEY	Gemini API Key	无	使用 Gemini 时必填，从 Google AI Studio 获取
GEMINI_BASE_URL	Gemini API 地址	无	可选，默认 [***]
GEMINI_MODEL	Gemini 模型	gemini-2.5-flash	可选，如 gemini-2.5-pro、gemini-3.0-flash 等

OpenAI 配置

环境变量	描述	默认值	说明
OPENAI_API_KEY	OpenAI API Key	无	使用 OpenAI 时必填，从 OpenAI Platform 获取
OPENAI_BASE_URL	OpenAI API 地址	无	可选，默认 [***]
OPENAI_MODEL	OpenAI 模型	gpt-4o	可选，如 gpt-4-turbo、o3、o4-mini 等

Azure OpenAI 配置

环境变量	描述	默认值	说明
AZURE_OPENAI_API_KEY	Azure API Key	无	使用 Azure OpenAI 时必填，从 Azure 门户获取
AZURE_OPENAI_ENDPOINT	Azure Endpoint	无	Azure 资源端点，如 [***]
AZURE_OPENAI_DEPLOYMENT	部署名称	无	Azure 中配置的部署名称，如 gpt-4o
AZURE_OPENAI_API_VERSION	API 版本	2024-02-15-preview	可选，Azure API 版本
AZURE_OPENAI_MODEL	Azure 模型	gpt-4o	可选，显示用的模型名称

5. 初始化数据库

npx prisma migrate dev
npx prisma db seed

6. 管理员账户

默认管理员账户：

***: admin@localhost
密码: ***

[!NOTE] 管理员登录后，可在“设置” -> “用户管理”中管理系统用户。

7. 启动开发服务器

npm run dev

访问 [***] 开始使用。

⚙️ AI 模型配置

本项目支持动态配置 AI 模型，无需重启服务器。

进入设置：点击首页右上角的设置图标。
选择提供商：支持 Google Gemini、OpenAI 和 Azure OpenAI。
填写参数：
- 通用参数: API Key、Base URL（或 Endpoint）、Model Name（或 Deployment Name）。
- Azure 特有: Deployment Name（部署名称）、API Version（API 版本）。
保存生效：点击保存后即刻生效。

[!NOTE] 注意：网页配置会保存到 config/app-config.json 文件中，该文件的优先级高于 .env 环境变量。

配置样例

选择提供商后，填写对应参数即可。各服务商获取方式如下：

Google Gemini

参数	获取方式
API Key	Google AI Studio → 创建 API Key
Base URL	默认 [***]
模型	gemini-2.5-flash（推荐）、gemini-2.5-pro、gemini-3.0-flash 等

OpenAI

参数	获取方式
API Key	OpenAI Platform → Create new secret key
Base URL	默认 [***]
模型	gpt-4o（推荐）、gpt-4-turbo、o3、o4-mini 等

[!NOTE] 兼容模式：OpenAI 提供商兼容所有支持 OpenAI API 格式的第三方服务。只需将 Base URL 改为对应服务地址，即可使用硅基流动、智谱 GLM、月之暗面 Kimi、通义千问 DashScope 等平台的模型。模型名称需填写对应平台的完整模型 ID。

Azure OpenAI

参数	获取方式
API Key	Azure 门户 → 你的 OpenAI 资源 → 密钥和终结点
Endpoint	Azure 门户 → 你的 OpenAI 资源 → 终结点，如 [***]
部署名称	Azure 中配置的模型部署名称，如 gpt-4o
API 版本	默认 2024-02-15-preview
模型	显示用的模型名称，如 gpt-4o

🛠️ 实用脚本

在 scripts/ 目录下提供了一些实用脚本，用于维护和调试：

重置密码:

node scripts/reset-password.js

示例:

node scripts/reset-password.js user@example.com 123456

📸 屏幕截图功能 (HTTPS 设置)

本应用的屏幕截图功能依赖浏览器的安全上下文 (HTTPS)。在 Docker 或局域网环境中使用时，请参考 HTTPS 配置指南 启用内置 HTTPS 支持。

📱 PWA 支持 (添加到主屏幕)

本项目支持 PWA (Progressive Web App)，您可以将应用添加到手机主屏幕，获得原生应用般的使用体验。

功能特性：

🚀 快速启动：点击主屏幕图标直接打开，无需输入网址。
📱 沉浸体验：全屏运行，无浏览器地址栏干扰。
🎨 原色适配：应用图标和启动画面适配系统主题。

使用方法：

iPhone / iPad (Safari): 点击底部分享按钮 -> 选择 "添加到主屏幕"。
Android (Chrome): 点击右上角菜单 -> 选择 "添加到主屏幕" 或 "安装应用"。

🛠️ 技术栈

框架: Next.js 16 (App Router)
UI 库: React 19
数据库: SQLite (via Prisma)
样式: Tailwind CSS v4 + Shadcn UI
AI: Google Gemini API / OpenAI API / Azure OpenAI
认证: NextAuth.js

🚀 快速开始

方式一：使用 Docker 部署

1. 启动服务

您可以选择 直接使用命令 (适合快速测试) 或 Docker Compose (适合长期运行)。

选项 A：直接使用 Docker 命令

docker run -d --name wrong-notebook \
-e NEXTAUTH_SECRET="your_secret_key" \
-p 3000:3000 \
-v $(pwd)/data:/app/data \
-v $(pwd)/config:/app/config \
ghcr.io/wttwins/wrong-notebook

选项 B：使用 Docker Compose (推荐)

使用 docker-compose.yml 文件进行管理。

下载配置文件：

curl -o docker-compose.yml https://raw.githubusercontent.com/wttwins/wrong-notebook/refs/heads/main/docker-compose.yml

启动服务：

docker-compose up -d

查看日志：

docker-compose logs -f

停止服务：

docker-compose down

方式二：本地源码运行

1. 克隆仓库

git clone https://github.com/wttwins/wrong-notebook.git
cd wrong-notebook

2. 环境准备

确保已安装 Node.js (v18+) 和 npm。

3. 安装依赖

npm install

4. 配置环境变量

复制 .env.example 为 .env 并填入必要的配置：

cp .env.example .env

基础配置

环境变量	描述	默认值	说明
`DATABASE_URL`	数据库连接地址	`file:./dev.db`	SQLite 数据库路径
`NEXTAUTH_SECRET`	Auth 密钥	无	用于加密 Session，生产环境建议设置，可以使用 openssl rand -base64 32 生成一个随机字符串作为密钥
`NEXTAUTH_URL`	访问地址	`http://your-domain-name:3000`	部署后的访问地址
`AUTH_TRUST_HOST`	信任主机头	`true`	设置为 `true` 时自动推断 URL，适合 Docker/PaaS
`LOG_LEVEL`	日志级别	`debug` (开发) / `info` (生产)	可选值：`trace`, `debug`, `info`, `warn`, `error`, `fatal`
`HTTP_PROXY`	HTTP 代理	无	设置 HTTP 代理
`HTTPS_PROXY`	HTTPS 代理	无	设置 HTTPS 代理

AI 配置

环境变量	描述	默认值	说明
`AI_PROVIDER`	AI 提供商	`gemini`	可选 `gemini`、`openai` 或 `azure`

Gemini 配置

环境变量	描述	默认值	说明
`GOOGLE_API_KEY`	Gemini API Key	无	使用 Gemini 时必填，从 Google AI Studio 获取
`GEMINI_BASE_URL`	Gemini API 地址	无	可选，默认 `https://generativelanguage.googleapis.com`，通常无需修改
`GEMINI_MODEL`	Gemini 模型	`gemini-2.5-flash`	可选，如 `gemini-2.5-pro`、`gemini-3.0-flash` 等

OpenAI 配置

环境变量	描述	默认值	说明
`OPENAI_API_KEY`	OpenAI API Key	无	使用 OpenAI 时必填，从 OpenAI Platform 获取
`OPENAI_BASE_URL`	OpenAI API 地址	无	可选，默认 `https://api.openai.com/v1`；使用第三方兼容服务时填写对应地址
`OPENAI_MODEL`	OpenAI 模型	`gpt-4o`	可选，如 `gpt-4-turbo`、`o3`、`o4-mini` 等

Azure OpenAI 配置

环境变量	描述	默认值	说明
`AZURE_OPENAI_API_KEY`	Azure API Key	无	使用 Azure OpenAI 时必填，从 Azure 门户获取
`AZURE_OPENAI_ENDPOINT`	Azure Endpoint	无	Azure 资源端点，如 `https://xxx.openai.azure.com`
`AZURE_OPENAI_DEPLOYMENT`	部署名称	无	Azure 中配置的部署名称，如 `gpt-4o`
`AZURE_OPENAI_API_VERSION`	API 版本	`2024-02-15-preview`	可选，Azure API 版本
`AZURE_OPENAI_MODEL`	Azure 模型	`gpt-4o`	可选，显示用的模型名称

5. 初始化数据库

npx prisma migrate dev
npx prisma db seed

6. 管理员账户

默认管理员账户：

*******: admin@localhost
密码: 123456

[!NOTE] 管理员登录后，可在“设置” -> “用户管理”中管理系统用户。

7. 启动开发服务器

npm run dev

访问 [***] 开始使用。

⚙️ AI 模型配置

本项目支持动态配置 AI 模型，无需重启服务器。

进入设置：点击首页右上角的设置图标。
选择提供商：支持 Google Gemini、OpenAI 和 Azure OpenAI。
填写参数：

通用参数: API Key、Base URL（或 Endpoint）、Model Name（或 Deployment Name）。
Azure 特有: Deployment Name（部署名称）、API Version（API 版本）。

保存生效：点击保存后即刻生效。

[!NOTE] 网页配置会保存到 config/app-config.json 文件中，该文件的优先级高于 .env 环境变量。

配置样例

选择提供商后，填写对应参数即可。各服务商获取方式如下：

Google Gemini

参数	获取方式
API Key	Google AI Studio → 创建 API Key
Base URL	默认 `https://generativelanguage.googleapis.com`，通常无需修改
模型	`gemini-2.5-flash`（推荐）、`gemini-2.5-pro`、`gemini-3.0-flash` 等

OpenAI

参数	获取方式
API Key	OpenAI Platform → Create new secret key
Base URL	默认 `https://api.openai.com/v1`
模型	`gpt-4o`（推荐）、`gpt-4-turbo`、`o3`、`o4-mini` 等

[!NOTE] 兼容模式：OpenAI 提供商兼容所有支持 OpenAI API 格式的第三方服务。只需将 Base URL 改为对应服务地址，即可使用硅基流动、智谱 GLM、月之暗面 Kimi、通义千问 DashScope 等平台的模型。模型名称需填写对应平台的完整模型 ID。

Azure OpenAI

参数	获取方式
API Key	Azure 门户 → 你的 OpenAI 资源 → 密钥和终结点
Endpoint	Azure 门户 → 你的 OpenAI 资源 → 终结点，如 `https://xxx.openai.azure.com`
部署名称	Azure 中配置的模型部署名称，如 `gpt-4o`
API 版本	默认 `2024-02-15-preview`
模型	显示用的模型名称，如 `gpt-4o`

🛠️ 实用脚本

在 scripts/ 目录下提供了一些实用脚本，用于维护和调试：

重置密码:

node scripts/reset-password.js

示例:

node scripts/reset-password.js user@example.com 123456

📄 许可证

MIT License

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

需要其他帮助？请查看我们的常见问题 Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

排错

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

DNS 超时

DNS 解析 · 网络超时

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"