高颜值轻量化NAS导航面板！NOWEN一键Docker部署教程

集书签管理与系统监控于一体的极简个人导航站。
✨ 特性
    📚 书签管理 — 拖拽排序、分类标签、置顶 / 稍后阅读、AI 自动元数据与标签
    🖥️ 系统监控 — CPU / 内存 / 硬盘 / 网络 / 温度 / Docker 容器实时状态
    🔍 Spotlight 搜索 — ⌘/Ctrl + K 全局搜索，支持书签和命令
    🎨 主题系统 — 8 款预设主题，深 / 浅双模式，跟随系统或时间自动切换
    🌐 国际化 — 中文 / English / 日本語 / 한국어
    💾 数据安全 — Named Volume + 多层备份机制，支持 WebDAV 云备份
    🚀 多架构支持 — x86_64 / ARM64（适配树莓派、RK3588 等开发板）
    📱 响应式 — 桌面 Dock 与移动端悬浮坞，触觉反馈



🚀 快速开始
Docker（推荐）

1. docker run -d \
   
2.   --name nowen \
   
3.   -p 3000:3000 \
   
4.   -v nowen-data:/app/server/data \
   
5.   -v nowen-backup:/app/.data-backup \
   
6.   --restart unless-stopped \
   
7.   cropflre/nowen:latest

复制代码

打开 http://localhost:3000，使用默认账号登录：
用户名     密码
admin     admin123
    ⚠️ 首次登录后请立即修改默认密码。
Docker Compose

1. services:
   
2.   nowen:
   
3.     image: cropflre/nowen:latest
   
4.     container_name: nowen
   
5.     ports:
   
6.       - "3000:3000"
   
7.     volumes:
   
8.       - nowen-data:/app/server/data
   
9.       - nowen-backup:/app/.data-backup
   
10.     restart: unless-stopped
    
11. 
    
12. volumes:
    
13.   nowen-data:
    
14.   nowen-backup:

复制代码

1. docker compose up -d

复制代码

本地开发

1. # 克隆并安装
   
2. git clone <a href="https://github.com/cropflre/NOWEN.git" target="_blank">https://github.com/cropflre/NOWEN.git</a>
   
3. cd NOWEN
   
4. npm install
   
5. cd server && npm install && cd ..
   
6. 
   
7. # 启动后端（端口 3001）
   
8. cd server && npm run dev
   
9. 
   
10. # 启动前端（端口 5173，新终端）
    
11. npm run dev

复制代码

🛠️ 技术栈

前端：React 18 · TypeScript · Vite · Tailwind CSS · Framer Motion · @dnd-kit · SWR · i18next
后端：Express · sql.js (SQLite) · systeminformation · Cheerio · WebDAV · node-cron
部署：Docker（多架构）· Nginx · GitHub Actions

⌨️ 快捷键
快捷键     功能
⌘/Ctrl + K     Spotlight 搜索
⌘/Ctrl + N     新建书签
Esc     关闭弹窗
↑ ↓ / Enter     列表导航 / 确认

📦 数据持久化
数据库位于容器内 /app/server/data/zen-garden.db。建议保留默认的 Named Volume 配置，配合 8 层防呆机制（双卷互备、启动备份、运行时同步、SQLite 完整性校验等）保证数据安全。
也可在后台启用 WebDAV 云备份（坚果云 / 群晖 / Alist 等）实现定时异地备份。

📡 API 文档
REST API 详情见 server/ 目录下的路由代码，主要包含：
    /api/bookmarks — 书签 CRUD、标签、批量操作
    /api/categories — 分类管理
    /api/admin — 登录、修改密码 / 用户名
    /api/system — 实时硬件监控数据
    /api/visits — 访问统计
    /api/health-check — 链接健康检测
    /api/backup — 备份与 WebDAV
    /api/ai — AI 标签 / 分类 / 元数据