vanhack/easyappointments

Easy!Appointments Docker镜像文档

镜像概述

Easy!Appointments是一个高度可定制的开源预约调度Web应用，允许客户通过复杂的Web界面进行预约。它支持与Google日历同步，可与现有网站无缝集成，并支持自托管安装，即使商业用途也可免费使用。该Docker镜像封装了应用的完整运行环境，简化部署流程。

核心功能与特性

• 客户与预约管理：全面的客户信息管理和预约生命周期跟踪
• 服务与提供者组织：灵活管理服务类型、提供者信息及可用性
• 工作计划与预约规则：自定义工作时间、休息时段和预约限制规则
• Google日历同步：双向同步预约数据，与其他服务协同工作
• 邮件通知系统：自动发送预约确认、提醒和变更通知
• 自托管部署：可在私有服务器上安装，确保数据安全
• 多语言界面：支持多种语言，适应不同地区用户需求
• 社区支持：活跃的用户社区提供技术支持和问题解答

使用场景与适用范围

适用于各类需要管理客户预约的机构和个人，包括但不限于：

• 诊所、牙科诊所等机构
• 美容院、健身房等服务型企业
• 咨询公司、律师事务所等专业服务机构
• 教育培训机构的课程预约
• 自由职业者的时间安排管理

使用方法与配置说明

前提条件

• Docker Engine (1.13.0+)
• Docker Compose (可选，推荐用于多容器部署)
• 可用的MySQL/MariaDB数据库实例

快速启动 (docker run)

bash
docker run -d \
  --name easyappointments \
  -p 80:80 \
  -e MYSQL_HOST=mysql-host \
  -e MYSQL_USER=dbuser \
  -e MYSQL_PASSWORD=dbpass \
  -e MYSQL_DATABASE=easyappointments \
  -e BASE_URL=http://your-domain.com \
  vhs/easyappointments:latest

Docker Compose 配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  easyappointments:
    image: vhs/easyappointments:latest
    ports:
      - "80:80"
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=root
      - MYSQL_PASSWORD=secret
      - MYSQL_DATABASE=easyappointments
      - BASE_URL=http://localhost
    depends_on:
      - db
    restart: always

  db:
    image: mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=easyappointments
    restart: always

volumes:
  db_data:

启动服务：

bash
docker-compose up -d

环境变量配置

初始化设置

1. 启动容器后，访问http://your-domain.com或http://localhost
2. 按照网页安装向导完成初始配置
3. 创建管理员账户
4. 设置服务、提供者和工作时间
5. (可选) 配置Google日历同步

数据持久化

为确保数据不丢失，建议挂载以下目录：

• /var/www/html/storage：应用存储目录（包含上传文件、缓存等）
• 使用外部数据库或挂载MySQL数据卷（如上述docker-compose示例中的db_data卷）

支持与资源

• 官方网站：easyappointments.org
• GitHub仓库：https://github.com/alextselegidis/easyappointments
• 支持社区：Google Groups
• 问题反馈：https://github.com/alextselegidis/easyappointments/issues

许可证

应用代码基于 GPL v3.0 许可，内容基于 CC BY 3.0 许可。