azdek/fp-desktop 镜像文档

镜像概述

azdek/fp-desktop是一个面向桌面应用场景的Docker镜像，设计用于提供需与Redis服务器交互的服务能力。该镜像通过容器化方式简化部署流程，支持灵活配置与持久化运行，适用于需要稳定连接Redis并通过Web界面访问的桌面应用场景。

核心功能与特性

• Redis集成：需配置Redis服务器IP（通过REDIS_SERVER_IP环境变量），实现与Redis服务的交互
• Web访问支持：默认通过容器80端口提供服务，可映射主机端口（如8080）实现外部访问
• 持久化运行：支持--restart always配置，确保服务异常退出后自动重启
• 容器管理：提供标准化容器命名（fp-desktop），便于识别与管理

使用场景

• 需要与Redis数据库交互的桌面应用后端服务部署
• 需通过Web界面访问的桌面应用容器化部署
• 要求服务高可用性、自动恢复的场景

使用方法与配置说明

镜像构建

通过以下命令构建本地镜像：

bash
docker build -t azdek/fp-desktop:latest .

镜像推送（可选）

如需共享镜像，可推送至Docker仓库：

bash
docker push azdek/fp-desktop:latest

容器运行

基础运行命令

bash
docker run -d \
  -e REDIS_SERVER_IP='10.10.0.12' \  # Redis服务器IP地址，必填
  -p 8080:80 \                      # 端口映射：主机8080端口 -> 容器80端口
  --restart always \                # 自动重启策略：总是重启
  --name fp-desktop \               # 容器名称：fp-desktop
  azdek/fp-desktop:latest

关键配置参数说明

容器管理

• 停止容器：docker stop fp-desktop
• 删除容器：docker rm fp-desktop
• 查看日志：docker logs fp-desktop
• 重启容器：docker restart fp-desktop

注意事项

• 确保Redis服务器IP（REDIS_SERVER_IP）配置正确且容器可访问该Redis服务
• 主机8080端口需未被占用，如需使用其他端口，可修改端口映射（如-p 8081:80）
• 首次运行前建议检查Docker环境是否正常，确保镜像已成功拉取或构建