eibrahim/fluid-calendar

开源日历与日程安排应用 Docker 镜像文档

一、镜像概述和主要用途

本镜像是一个开源的日历与日程安排应用，作为商业工具 Motion 的替代方案，旨在提供高效、灵活的时间管理解决方案。该应用支持日程可视化、会议预约、任务管理及时间块规划等核心功能，适用于个人和团队的日常时间协调与规划。

二、核心功能和特性

2.1 核心功能

• 日程可视化：提供月/周/日视图，直观展示日程安排；
• 会议预约：支持他人通过链接预约会议时间，自动避开已有日程冲突；
• 任务管理：整合任务列表与日程，支持任务优先级排序与时间分配；
• 时间块规划：自动或手动将任务/会议分配至时间块，优化时间利用效率；
• 跨平台同步：支持与 CalDAV、Google Calendar 等第三方日历服务同步数据。

2.2 关键特性

• 开源可定制：基于 MIT/Apache 许可证开源，支持二次开发与功能扩展；
• 轻量部署：Docker 容器化部署，无需复杂依赖配置；
• 数据隐私：本地存储或私有数据库部署，保障数据安全；
• 多语言支持：内置中英文等多语言界面；
• API 集成：提供 REST API，支持与其他工具（如 Slack、Notion）集成。

三、使用场景和适用范围

3.1 典型使用场景

• 个人时间管理：规划每日任务、会议及个人日程；
• 团队协作：团队成员共享日程，快速协调会议时间；
• 自由职业者：管理客户预约、项目截止日期及个人时间分配；
• 企业内部协调：部门间日程共享，减少跨团队沟通成本。

3.2 适用范围

• 个人用户：需要高效规划日常时间的个人；
• 小型团队：10人以下团队的协作会议与任务安排；
• 开发人员：需自定义功能或集成内部系统的技术团队。

四、使用方法和配置说明

4.1 基本使用流程

1. 拉取 Docker 镜像；
2. 配置环境变量（如数据库、端口、管理员账户等）；
3. 运行容器并挂载持久化存储卷；
4. 通过浏览器访问应用界面，完成初始化设置。

4.2 Docker 部署方案示例

4.2.1 快速启动（Docker Run）

bash
docker run -d \
  --name calendar-app \
  -p 8080:8080 \
  -e TZ=Asia/Shanghai \
  -e PORT=8080 \
  -e DB_TYPE=sqlite \
  -e ADMIN_EMAIL=admin@example.com \
  -e ADMIN_PASSWORD=Admin123! \
  -v ./calendar-data:/app/data \
  [镜像名称]:latest

4.2.2 Docker Compose 配置（推荐）

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  calendar-app:
    image: [镜像名称]:latest
    container_name: calendar-app
    restart: always
    ports:
      - "8080:8080"
    environment:
      TZ: Asia/Shanghai
      PORT: 8080
      DB_TYPE: postgres  # 可选：sqlite/postgres/mysql
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: calendar_user
      DB_PASSWORD: secure_password
      DB_NAME: calendar_db
      ADMIN_EMAIL: admin@example.com
      ADMIN_PASSWORD: Admin123!
      LOG_LEVEL: info
    volumes:
      - ./app-data:/app/data  # 持久化应用配置与日志
    depends_on:
      - db

  db:
    image: postgres:14-alpine
    container_name: calendar-db
    restart: always
    environment:
      POSTGRES_USER: calendar_user
      POSTGRES_PASSWORD: secure_password
      POSTGRES_DB: calendar_db
    volumes:
      - ./db-data:/var/lib/postgresql/data  # 持久化数据库数据

启动服务：

bash
docker-compose up -d

4.3 环境变量配置说明

4.4 持久化数据

为避免容器重启后数据丢失，需挂载以下目录：

• /app/data：存储应用配置、用户数据及 sqlite 数据库文件（若使用 sqlite）；
• 数据库卷（如 db-data）：若使用外部数据库（postgres/mysql），需单独挂载数据库存储目录。

4.5 访问应用

容器启动后，通过浏览器访问 http://[主机IP]:8080，使用配置的 ADMIN_EMAIL 和 ADMIN_PASSWORD 登录，完成初始设置（如创建用户、导入日历等）。

五、注意事项

1. 数据备份：定期备份挂载的 app-data 和数据库卷，避免数据丢失；
2. 安全配置：生产环境中需修改默认管理员密码，并通过反向代理（如 Nginx）启用 HTTPS；
3. 版本更新：更新镜像时，需确保环境变量与旧版本兼容，建议先备份数据。