g82tt
68be41e7a2
# 项目概述 个人浏览器首页导航应用，支持书签分类管理、搜索引擎快捷搜索、 必应每日壁纸轮播、前后端分离部署，适配 1Panel 服务器（Docker 模式）。 # 技术栈 - 前端：Vue 3 + TypeScript + Vite + Pinia + Capacitor（Android 打包） - 后端：.NET 8 + SqlSugar（多数据库） + SQLite/MySQL + Swashbuckle - 部署：1Panel 应用商店自定义应用（Docker Compose 模式） # 项目结构 - backend/ .NET 8 API 后端（8 个 Controller + 15 个 Service） - frontend/ Vue 3 前端（19 个组件 + 9 个 API 模块 + 5 个 Store） - docker/ Docker 部署文件（后端镜像 + Nginx 反代） - docs/ 部署手册（1Panel 实战版） - scripts/ E2E 测试脚本 # 已实现功能 - 书签管理：增删改查 + 树形分类 + 拖拽排序 + 主色自适应 - 搜索引擎：8 个内置引擎 + 自定义引擎 + favicon 自动抓取 - 必应壁纸：每日轮播 + 多分辨率自动选择 + 1.6MP 质量优先 - 全局设置：主题/行为/数据/工具 4 分类 + 跨设备同步 - 文件上传：图标/书签/通用（容器持久化 + 跨域 URL 拼接） - 同步：基于变更日志的设备间数据同步 - 跨域部署：前后端分离 + runtime config.json 无需重新编译 # 进度记录 - 已完成 P0~P52 共 53 个开发节点（详细见 说明文档.md） - 当前版本：v1.0 部署就绪 # 部署文档 - README.md：项目说明 + 快速开始 - 说明文档.md：完整开发进度（中文） - docs/DEPLOY.md：1Panel 部署手册（Docker 模式）
1.0 KiB
1.0 KiB
Docker 部署说明
快速启动
# 1. 启动（首次会构建镜像，5-10 分钟）
docker compose up -d --build
# 2. 查看日志
docker compose logs -f backend
# 3. 停止
docker compose down
# 4. 清理（含数据卷）
docker compose down -v
启动后访问：
- 前端 + 后端（同一镜像）: http://localhost:8080
- Swagger: http://localhost:8080/swagger
- MySQL: 127.0.0.1:3306（用户
myhomepage，密码见docker-compose.yml或环境变量MYSQL_PASSWORD）
数据库切换
默认使用 MySQL。如需切换到 SQLite，修改 docker-compose.yml 中 backend 的环境变量：
Database__Provider: Sqlite
Database__ConnectionString: "Data Source=/app/data/myhomepage.db"
volumes:
- sqlite-data:/app/data
并添加卷：
volumes:
sqlite-data:
上传目录
上传文件落到容器内 /app/Uploads，通过 uploads-data 卷持久化。
可通过环境变量 Upload__Path 修改（必须以 / 开头表示容器内绝对路径）。