Hotel Management System

第一步：环境准备

你需要一台 Linux 服务器（Ubuntu 22.04/24.04 推荐），安装 Docker 和 Docker Compose：

sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker

第二步：拉取 QloApps Docker 镜像

QloApps 官方提供了 Docker 镜像，直接拉取即可：

docker pull webkul/qloapps_docker

第三步：启动容器

QloApps 需要一个 MySQL 数据库。你可以用 Docker Compose 同时启动数据库和应用，或者先用 docker run 快速测试。推荐用 Compose：

创建一个 docker-compose.yml 文件：

version: '3.8'

services:
  db:
    image: mysql:8.0
    container_name: qloapps-db
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: qloapps
      MYSQL_USER: qloapps
      MYSQL_PASSWORD: your_db_password
    volumes:
      - ./mysql_data:/var/lib/mysql
    restart: unless-stopped

  qloapps:
    image: webkul/qloapps_docker
    container_name: qloapps
    depends_on:
      - db
    ports:
      - "8080:80"
    environment:
      DB_HOST: db
      DB_NAME: qloapps
      DB_USER: qloapps
      DB_PASSWORD: your_db_password
    volumes:
      - ./qloapps_data:/var/www/html
    restart: unless-stopped

然后启动：

docker-compose up -d

第四步：完成 Web 安装向导

浏览器打开 http://你的服务器IP:8080，QloApps 会启动安装向导。按照提示填写数据库连接信息（用上面 Compose 里配置的 qloapps 用户和密码），系统会自动建表并完成初始化-9。

第五步：基础配置

安装完成后登录后台，建议先做三件事：

1. 修改管理员密码：默认账号密码通常在安装时设置，不要用弱密码。
2. 配置房型和房间：在“客房管理”中创建房型（如标准间、套房），再创建具体房间并关联房型。
3. 设置支付方式：如果要在本站接受在线支付，需要在支付模块中配置 PayPal 或其他网关（QloApps 支持 PayPal，其他网关可能需要额外开发）。

第六步：渠道管理（可选）

如果酒店在 Booking.com 等 OTA 上有房源，可以配置渠道管理器同步房态。注意：部分渠道同步功能在 QloApps 中可能需要付费插件或额外配置，具体以你安装版本的模块列表为准。

需要注意的坑

镜像版本：webkul/qloapps_docker 的标签可能更新较慢，建议拉取 latest 并查看 Docker Hub 上的最近更新日期。如果安装向导报 PHP 版本或扩展错误，说明镜像内的 PHP 版本可能不符合当前 QloApps 的要求（QloApps 要求 PHP 8.1+）。

数据持久化：上面的 Compose 文件已经把 MySQL 数据和 QloApps 的 /var/www/html 目录映射到了宿主机，不要删除这两个目录，否则数据会丢失。

生产环境：测试用 docker-compose 没问题，正式对外运营时建议：

• 用 Nginx 反向代理并配置 HTTPS。
• 修改所有默认密码（数据库 root、应用数据库用户、管理员账号）。
• 设置定时备份 mysql_data 目录或使用 mysqldump。