pe46dro/xbackbone-docker

XBackBone Docker镜像文档

镜像概述和主要用途

本镜像基于https://dockerfile.readthedocs.io/en/latest/content/DockerImages/dockerfiles/php-nginx.html%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E9%83%A8%E7%BD%B2https://github.com/SergiX44/XBackBone%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AA%E7%AE%80%E5%8D%95%E8%BD%BB%E9%87%8F%E7%9A%84ShareX PHP后端，支持文件上传、分享和管理功能。

支持的标签及对应Dockerfile

• [latest（本仓库/src/Dockerfile）]
• [3.3,3.3.3（src/Dockerfile）]
• [3.2,3.2.0（src/Dockerfile）]
• [3.1,3.1.4（src/Dockerfile）]
• [3.0,3.0.2（src/Dockerfile）]
• [2.6,2.6.5（src/Dockerfile）]
• [2.6.3（src/Dockerfile）]
• [2.6.0（src/Dockerfile）]
• [2.5,2.5.3（src/Dockerfile）]
• [2.5.0（src/Dockerfile）]
• [2.4, 2.4.1（src/Dockerfile）]
• https://github.com/Pe46dro/XBackBone-docker/tree/dev

快速参考

• 问题反馈地址：
  https://github.com/Pe46dro/XBackBone-docker/issues

• 支持的架构：amd64

• 支持的Docker版本：
  https://github.com/docker/docker-ce/releases/latest%EF%BC%88%E6%9C%80%E4%BD%8E%E6%94%AF%E6%8C%811.6%E7%89%88%E6%9C%AC%EF%BC%8C%E5%B0%BD%E5%8A%9B%E5%85%BC%E5%AE%B9%EF%BC%89

使用方法

基本启动命令

使用以下命令启动容器并映射端口到主机：

console
$ docker run -p 80:80 \
    -e APP_NAME=XBackBone \
    -e URL=http:\/\/127.0.0.1 \
    --name xbb \
    pe46dro/xbackbone-docker

容器日志查看

Nginx服务器日志可通过Docker容器日志查看：

console
$ docker logs xbb

环境变量

启动镜像时，可通过docker run命令行传递环境变量调整配置：

APP_NAME

指定应用名称，未提供时默认值为XBackBone
示例：-e APP_NAME=XBackBone

URL

指定应用URL，斜杠需转义
示例：-e URL=http:\/\/127.0.0.1

GENERATE_RELEASE=TRUE（仅dev标签可用）

设置后将生成发布zip包并放置于srv/xbb/storage

构建参数

自行构建镜像时，可通过--build-arg variable=value参数调整版本：

XBACKBONE_VERSION

指定https://github.com/SergiX44/XBackBone/releases%EF%BC%8C%E4%BB%A5%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E7%89%88%E6%9C%AC

数据存储

可用挂载点

• /app/storage
• /app/resources/database
• /app/logs
• /app/config（用于保留配置文件 - 仅Docker容器）

权限要求

主机系统上的文件夹需设置UID和GID为1000

示例

bash
mkdir -p /srv/xbb/storage
mkdir -p /srv/xbb/database
mkdir -p /srv/xbb/logs
mkdir -p /srv/xbb/config

chown -R 1000:1000 /srv/xbb

PHP自定义配置

可通过环境变量指定PHP配置，例如php.memory_limit=256M将设置memory_limit = 256M。更多详情参考https://dockerfile.readthedocs.io/en/latest/content/DockerImages/dockerfiles/php-nginx.html#php-ini-variables

MySQL数据库配置

• 克隆仓库
• 在xbb.env中自定义环境变量
• 构建并运行

bash
git clone https://github.com/Pe46dro/XBackBone-docker.git .
docker-compose up -d

LDAP认证

可通过以下环境变量配置LDAP认证：

• LDAP_ENABLED
• LDAP_HOST
• LDAP_PORT
• LDAP_BASE_DOMAIN
• LDAP_USER_DOMAIN
• LDAP_RDN_ATTRIBUTE

详细说明参考官方文档

版本升级（从<3.1.4版本升级）

升级前执行以下命令：
echo '-' > YOUR_STORAGE_VOLUME/storage/.installed

维护者

• https://github.com/Pe46dro - 创建者

许可证

查看许可证信息了解本镜像中软件的许可条款。