wandergame/wandernote repository overview

⁠WanderNote - 自托管个人笔记应用

一个轻量级自托管笔记应用，支持 SQLite/MySQL/MariaDB 数据库，内置文件存储功能。通过 Docker 实现一键部署，数据完全自主控制。

⁠✨ 功能特性

• 多数据库支持（SQLite/MySQL/MariaDB）
• Markdown 笔记编辑与预览
• 文件附件存储管理
• 数据持久化存储
• 简易 Docker 部署

⁠镜像详情

镜像名称：wandergame/wandernote

端口映射：4800（应用服务端口，可根据实际情况调整）

⁠挂载目录

/app/data：用于存放本地数据文件，如日志文件、SQLite 数据库文件等，确保数据持久化。

/app/assets：专门用于存储笔记上传的文件，方便统一管理。

⁠环境变量配置

DB_TYPE：指定数据库类型，支持 sqlite、mysql、mariadb。例如：DB_TYPE=mysql

DB_HOST：填写数据库服务器的地址。例如：DB_HOST=192.168.1.100

DB_PORT：设置数据库服务监听的端口。例如：DB_PORT=3306

DB_USER：输入用于连接数据库的用户名。例如：DB_USER=root

DB_PASSWORD：对应上述用户的密码。例如：DB_PASSWORD=password123

DB_NAME：需提前创建好的数据库名称。例如：DB_NAME=wandernote_db

⁠安装与运行

拉取镜像：在终端执行以下命令，拉取 WanderNote 镜像。

docker pull wandergame/wandernote

运行容器（以 SQLite 数据库为例）：

docker run -d \
  --name wandernote \
  -p 4800:4800 \
  -v /your/data/path:/app/data \
  -v /your/assets/path:/app/assets \
  wandergame/wandernote

请将/host/path/to/data和/host/path/to/assets替换为您本地实际的目录路径。

3. 运行容器（以 MySQL 数据库为例）：

docker run -d \
  --name wandernote \
  -p 4800:4800 \
  -v /your/data/path:/app/data \
  -v /your/assets/path:/app/assets \
  -e DB_TYPE=mysql \
  -e DB_HOST=db.example.com \
  -e DB_PORT=3306 \
  -e DB_USER=db_user \
  -e DB_PASSWORD=db_password \
  -e DB_NAME=wandernote \
  wandergame/wandernote

请将/host/path/to/data和/host/path/to/assets替换为您本地实际的目录路径。

⁠使用方法

访问应用：在浏览器地址栏输入http://localhost:4800（若您修改了端口或使用了远程服务器，需相应调整地址），即可进入 WanderNote 应用界面。