ghcr.io/zczy-k/con-nav-item:main-efb916b

SmartNavora - AI 智能导航网站 v1.14.0

SmartNavora 是一款专为数字化工作者打造的 AI 智能导航网站。它不仅仅是一个链接收藏夹，更是一个集成了 AI 智能生成、多端同步、卡片化管理和浏览器深度集成的全能工作台。

📸 界面预览

现代化渐变卡片首页

🌟 亮点功能

• ⚡ 极速体验：基于 Vue 3 + Node.js，响应迅捷，前端构建轻量。
• 🤖 AI 赋能：内置多种主流 AI 适配，一键自动补全网站图标、描述、标签。
• 🧩 深度集成：配套强大的浏览器插件，支持新标签页接管、快捷搜藏。
• 📂 数据安全：内置 SQLite 数据库，支持本地备份与 WebDAV 云端备份。
• 🔒 安全增强：多重密码保护机制，审计日志，紧急恢复令牌。
• 🎨 颜值即正义：现代化渐变卡片 UI，支持暗黑模式，极致的视觉体验。

🆕 v1.14.0 更新内容

🔐 安全性增强

• ✅ 新增交互式密码重置功能，避免命令行泄露
• ✅ 紧急重置令牌系统（哈希存储，1小时过期）
• ✅ 完整的操作审计日志
• ✅ 密码重置不再显示明文
• ✅ Serv00 脚本集成密码管理功能

🛠️ 部署优化

• ✅ 修复 Serv00 重置功能不会断开 SSH 连接
• ✅ 改进重置流程，确保彻底清理残留
• ✅ 更详细的安装进度提示

📚 文档完善

• ✅ 新增 密码找回指南
• ✅ 新增 安全最佳实践
• ✅ 更新部署说明和使用指南

🐛 Bug 修复

• ✅ 修复安全漏洞（tar, fast-xml-parser, undici, cheerio）
• ✅ 优化依赖包版本

🚀 安装部署流程 (全流程指导)

无论你是拥有云服务器的大神，还是使用免费虚拟主机的学生党，都能轻松部署。

0. 先看这里（新手 1 分钟搞懂）

• 访问地址：http://你的IP:3000/，后台：http://你的IP:3000/admin
• 默认账号：admin / 123456（首次登录后务必修改）
• Docker 部署请务必持久化挂载 database/、backups/、config/，否则容器重建会丢配置/密钥
• 建议立刻设置两个环境变量：
  • ADMIN_PASSWORD：管理员密码（强密码）
  • CRYPTO_SECRET：用于加密 WebDAV/AI 等敏感配置（固定不变的随机字符串）

1. 选择部署方式

2. 执行安装命令

A. Linux 服务器 (Ubuntu/Debian/CentOS)

交互式安装：

bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/install-linux.sh)

B. Docker 部署（推荐）

方式一：Docker Compose（推荐）
创建 docker-compose.yml：

version: '3.8'
services:
  smartnavora:
    image: ghcr.io/zczy-k/smartnavora:latest
    container_name: SmartNavora
    restart: always
    ports:
      - "3000:3000"
    environment:
      - ADMIN_PASSWORD=你的强密码
      - CRYPTO_SECRET=随机字符串（至少16位）
      #- AUTO_BACKUP_ENABLED=false  # 低资源设备可选关闭自动备份
      #- TRUST_PROXY=true  # 反向代理环境可选开启
    volumes:
      - ./database:/app/database
      - ./backups:/app/backups
      - ./config:/app/config
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/healthz"]
      interval: 30s
      timeout: 10s
      retries: 3

启动服务：

docker compose up -d

方式二：Docker Run

docker run -d \
  --name SmartNavora \
  --restart always \
  -p 3000:3000 \
  -e ADMIN_PASSWORD=你的强密码 \
  -e CRYPTO_SECRET=随机字符串（至少16位） \
  -v $(pwd)/database:/app/database \
  -v $(pwd)/backups:/app/backups \
  -v $(pwd)/config:/app/config \
  ghcr.io/zczy-k/smartnavora:latest

[!NOTE] Docker 部署注意事项

• 请同时持久化 database/、backups/ 和 config/。缺少任何一个，容器重建都可能丢失数据、密钥或备份设置。
• 镜像不包含旧的 database/nav.db。如需保留现有数据，请挂载旧数据库目录或恢复备份到 /app/database。
• JWT_SECRET 和 CRYPTO_SECRET 可自动生成，但长期 Docker 部署仍建议显式设置，以便迁移。
• AUTO_BACKUP_ENABLED=false 为可选配置，仅推荐在低资源平台测试容器稳定性时使用。
• TRUST_PROXY 为可选配置。默认应用会自动信任常见私有/本地反向代理；如平台特殊，可显式设置 TRUST_PROXY=1、TRUST_PROXY=true 或其他 Express 支持的值。
• 推荐健康检查路径：/healthz（存活检查）和 /readyz（就绪检查）。
• 如启动日志显示 /app/database 或 /app/config 不可写，说明持久化卷挂载错误或不支持写入。

💡 强烈建议同时持久化 database/、backups/、config/ 三个目录：

• config/ 里包含 JWT 密钥与加密密钥（影响登录 token、WebDAV/AI 配置解密）
• database/ 里是你的数据
• backups/ 里是本地备份文件

C. Serv00 / 免费虚拟主机

方式一：使用系统自带域名 (推荐新手)

# 脚本会自动识别当前账号对应的默认域名
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/install-serv00.sh)

方式二：使用自定义域名

# 替换 yourdomain.com 为你的域名
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/install-serv00.sh) yourdomain.com

[!NOTE] 使用自定义域名前，请先在域名服务商处添加 CNAME 或 A 记录指向 Serv00 服务器。

3. 初始化配置 (安装后必看)

1. 访问后台：
   Linux / Docker 打开 http://你的IP:3000/admin；Serv00 打开 https://你的域名/admin。
2. 默认账号：用户名 admin，密码 123456。
3. 安全修改：进入 [用户与权限] 菜单，第一时间修改管理员用户名和密码。
4. 配置 AI：进入 [AI 配置]，填入你的 API Key（推荐 DeepSeek），测试通过后即可享受一键生成功能。
5. 配置 WebDAV（可选）：进入 [备份与恢复] → WebDAV 配置，保存成功后可在不同设备/服务器间同步备份。

4. 忘记密码？

如果忘记了管理员密码，可以通过以下方式重置：

Linux 服务器用户

# 方法1: 直接执行密码重置
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/manage-linux.sh) password

# 方法2: 使用交互式菜单
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/manage-linux.sh)
# 选择 2) 重置管理密码

# 方法3: 进入安装目录后交互式重置
cd ~/SmartNavora
node scripts/check-password.js interactive

Serv00 用户

# 使用管理脚本
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/manage-serv00.sh)
# 选择 3) 重置管理密码

Docker 用户

# 方法1: 直接运行重置脚本
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/docker-reset-password.sh)

# 方法2: 指定容器名运行重置脚本
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/docker-reset-password.sh) SmartNavora

# 方法3: 直接进入容器
docker exec -it SmartNavora node scripts/check-password.js interactive

📖 详细说明请查看 密码找回指南

📦 进阶使用指南

🌐 浏览器插件安装

想要实现“右键一键保存网站”或“新标签页即导航”？

1. 前往 https://github.com/zczy-k/SmartNavora/releases 下载最新 smartnavora-extension-v*.zip。
2. 解压后，在 Chrome/Edge 浏览器进入 chrome://extensions/。
3. 开启 开发者模式，选择 加载已解压的扩展程序。
4. 在插件设置中填入你的导航站地址，完成绑定。

🤖 如何让 AI 帮我干活？

1. 在后台添加一个只写了“URL”的卡片。
2. 勾选该卡片，点击 批量 AI 生成。
3. AI 会自动爬取标题、描述、图标并分类，点击“覆盖”或“补全”保存。

🔄 维护与升级

Docker 用户

# 如果你使用 docker compose（推荐）
docker compose pull
docker compose up -d

# 如果你使用 docker run
docker pull ghcr.io/zczy-k/smartnavora:latest
docker stop SmartNavora && docker rm SmartNavora
# 然后重新运行上面的 docker run 命令（务必包含 -v $(pwd)/config:/app/config 等持久化挂载）

脚本用户 (Linux/Serv00)

运行对应更新命令即可，更新流程会保留数据库和 .env 配置：

# Linux
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/manage-linux.sh) update

# Serv00
bash <(curl -Ls https://raw.githubusercontent.com/zczy-k/SmartNavora/main/scripts/manage-serv00.sh) update

🧯 常见问题（部署/升级相关）

1) WebDAV 保存/测试超时（ETIMEDOUT）

一些服务器 IPv6 出网异常但 DNS 返回 AAAA，会导致 WebDAV 测试连接超时。
本项目默认已在代码层面强制优先使用 IPv4（无需额外配置）。
如你确实需要访问 IPv6-only 资源，可设置 FORCE_IPV4=0 关闭。

2) Docker 中恢复备份报错 EBUSY（database 被占用）

当 database/ 目录被挂载且 SQLite 正在使用时，直接删除目录可能失败。
新版本已优化恢复逻辑：会先关闭数据库连接并改为清空目录内容再恢复。

🛠️ 技术栈

• 前端: Vue 3 + Vite
• 后端: Node.js + Express
• 数据库: SQLite3 (简单、快速、易迁移)
• AI 引擎: 多模型适配器 (OpenAI, DeepSeek, Claude, GLM, etc.)

📚 文档

• 密码找回指南 - 忘记密码的多种解决方案
• 安全最佳实践 - 安全使用建议和风险缓解

🔒 安全特性

• ✅ bcrypt 密码哈希加密
• ✅ JWT 令牌认证
• ✅ 紧急重置令牌（SHA-256 哈希存储）
• ✅ 操作审计日志
• ✅ 文件权限保护（0600）
• ✅ 依赖包安全更新

📄 许可证

本项目采用 Apache License 2.0 许可证。
特别感谢 https://github.com/eooce/nav-item 提供的灵感与基础。

---

⭐ 如果你喜欢这个项目，请点个 Star 鼓励一下！

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📞 支持

• https://github.com/zczy-k/SmartNavora/issues
• https://github.com/zczy-k/SmartNavora/releases