jgeusebroek/spotweb

Docker Spotweb镜像

镜像概述和主要用途

本镜像基于Ubuntu 20.04 Linux系统，运行Spotweb应用。Spotweb是一个Usenet Spot的Web界面，用于浏览、搜索和管理Usenet网络中的Spot信息。使用此镜像需配合独立的MySQL/MariaDB数据库服务器（可通过Docker容器或专用数据库服务器提供）。

前提要求

需要独立的MySQL/MariaDB服务器，可使用（链接的）Docker容器或专用数据库服务器。若使用docker-compose部署，可参考下方Docker Compose配置部分（感谢https://github.com/djongepier提供的指南）。

使用方法

初始安装

1. 准备数据库：在数据库服务器上创建数据库，并确保容器可访问该数据库。

2. 运行临时容器：

   bash
   docker run -it --rm -p 80:80 \
     -e TZ='Europe/Amsterdam' \
     docker.xuanyuan.run/jgeusebroek/spotweb
   

   注意：此处未配置数据库参数，目的是启用安装流程。

3. 通过Web界面完成安装：访问http://你的主机IP/install.php，使用Spotweb安装向导创建必要的数据库表和用户。忽略配置保存时的警告信息。

4. 退出临时容器：完成安装后，按CTRL/CMD+C退出容器，准备配置永久运行的容器。

永久安装

bash
docker run --restart=always -d -p 80:80 \
  --hostname=spotweb \
  --name=spotweb \
  -v <主机配置持久化目录>:/config \
  -e 'TZ=Europe/Amsterdam' \
  -e 'SPOTWEB_DB_TYPE=pdo_mysql' \
  -e 'SPOTWEB_DB_HOST=<数据库服务器主机名>' \
  -e 'SPOTWEB_DB_PORT=<数据库端口>' \
  -e 'SPOTWEB_DB_NAME=spotweb' \
  -e 'SPOTWEB_DB_USER=spotweb' \
  -e 'SPOTWEB_DB_PASS=spotweb' \
  docker.xuanyuan.run/jgeusebroek/spotweb

说明：

• /config卷为可选，仅在需要自定义配置时使用。
• 数据库端口为可选，未指定时使用MySQL/PostgreSQL默认端口。

完成后，通过http://你的主机IP访问Spotweb界面。

自动获取新Spot

可通过以下两种方式配置自动获取新Spot：

在Docker主机上配置

在主机的crontab中添加任务（示例每15分钟执行一次）：

bash
*/15 * * * * docker exec spotweb su -l www-data -s /usr/bin/php /var/www/spotweb/retrieve.php >/dev/null 2>&1

在容器内配置

通过环境变量SPOTWEB_CRON_RETRIEVE指定cron调度（示例每15分钟执行一次）：

bash
-e 'SPOTWEB_CRON_RETRIEVE=*/15 * * * *'

更新

容器会在新版本发布时自动尝试更新数据库结构。

Docker Compose配置

步骤说明

1. 创建基础目录并编辑docker-compose.yml（示例如下），根据需求修改环境变量。
2. 初始运行：docker-compose up -d
3. 删除配置文件：删除<基础目录>/spotweb/dbsettings.inc.php（否则安装流程无法启动，设置不会丢失）。
4. 完成Web安装：访问http://localhost:81/install.php，按向导完成安装，忽略配置保存错误。
5. 重启容器：docker-compose restart（dbsettings.inc.php会自动重建）。

示例docker-compose.yml

yaml
version: '3'
services:
  spotweb:
    image: docker.xuanyuan.run/jgeusebroek/spotweb
    ports:
      - "81:80"
    environment:
      - TZ=Europe/Amsterdam
      - SPOTWEB_DB_TYPE=pdo_mysql
      - SPOTWEB_DB_HOST=db
      - SPOTWEB_DB_NAME=spotweb
      - SPOTWEB_DB_USER=spotweb
      - SPOTWEB_DB_PASS=spotweb
    volumes:
      - ./spotweb:/config
    depends_on:
      - db
    restart: always
  db:
    image: docker.xuanyuan.run/mariadb
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=spotweb
      - MYSQL_USER=spotweb
      - MYSQL_PASSWORD=spotweb
    volumes:
      - ./mysql:/var/lib/mysql
    restart: always

环境变量说明

许可证

MIT / BSD

作者信息

Jeroen Geusebroek