docker --version && docker compose version

Docker version 29.9.2, build a82e528
Docker Compose version v5.6.1

mkdir -p /opt/froxlor-2.3.16/docker
cd /opt/froxlor-2.3.16

/opt/froxlor-2.3.16/
├── compose.yml                    # 编排：构建、端口、网络、持久化
├── init-db.sql                    # 数据库首启脚本（建全权限安装账号）
├── install.json                   # 无人值守安装参数
└── docker/
    ├── Dockerfile                 # 自建面板镜像定义
    ├── entrypoint.sh              # 首启拉起 cron 守护进程
    └── froxlor-2.3.16.tar.gz      # 官方 Release 包（构建上下文）

wget -P docker/ https://github.com/Froxlor/Froxlor/releases/download/2.3.16/froxlor-2.3.16.tar.gz
sha256sum docker/froxlor-2.3.16.tar.gz

316a68957778861bfb7b15cac7d2828f57ea1fac71c2d9091839a2b7b698177d  froxlor-2.3.16.tar.gz

FROM php:8.2-apache

RUN apt-get update && apt-get install -y --no-install-recommends \
        libpng-dev libjpeg62-turbo-dev libfreetype6-dev \
        libonig-dev libgmp-dev libicu-dev \
        cron mariadb-client unzip less vim-tiny \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j"$(nproc)" gd intl mbstring gmp bcmath pdo_mysql \
    && rm -rf /var/lib/apt/lists/*

COPY froxlor-2.3.16.tar.gz /tmp/
RUN tar xzf /tmp/froxlor-2.3.16.tar.gz -C /var/www/html/ \
    && rm /tmp/froxlor-2.3.16.tar.gz \
    && chown -R www-data:www-data /var/www/html/froxlor

COPY entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh

ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD ["apache2-foreground"]

#!/bin/bash
# start system cron daemon (froxlor writes /etc/cron.d/froxlor during installation)
service cron start >/dev/null 2>&1 || cron
exec "$@"

CREATE USER IF NOT EXISTS 'froxroot'@'%' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON *.* TO 'froxroot'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;

name: froxlor-2.3.16-stack

services:
  db:
    image: mariadb:10.11
    container_name: froxlor-2.3.16-db
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: q1w2e3r4
    volumes:
      - db-data:/var/lib/mysql
      - ./init-db.sql:/docker-entrypoint-initdb.d/init-db.sql:ro
    networks:
      - froxlor-net
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      start_period: 30s
      interval: 10s
      timeout: 5s
      retries: 5

  froxlor:
    build: ./docker
    image: froxlor/panel:2.3.16
    container_name: froxlor-2.3.16-panel
    hostname: panel.froxlor.test
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8141:80"
    volumes:
      - froxlor-data:/var/www/html/froxlor
    networks:
      froxlor-net:
        ipv4_address: 10.89.68.10

networks:
  froxlor-net:
    driver: bridge
    ipam:
      config:
        - subnet: 10.89.68.0/24
          gateway: 10.89.68.1

volumes:
  db-data:
  froxlor-data:

cd /opt/froxlor-2.3.16
docker compose build

 Image froxlor/panel:2.3.16 Building 
#1 [internal] load local bake definitions
#1 reading from stdin 540B done
#1 DONE 0.0s

#2 [internal] load build definition from Dockerfile
#2 transferring dockerfile: 813B done
#2 DONE 0.0s

#3 [internal] load metadata for docker.io/library/php:8.2-apache
#3 DONE 0.3s
...
#9 [2/6] RUN apt-get update && apt-get install -y --no-install-recommends ... CACHED
#10 [5/6] COPY entrypoint.sh /usr/local/bin/entrypoint.sh CACHED
#11 [6/6] RUN chmod +x /usr/local/bin/entrypoint.sh CACHED
#12 exporting to image

docker images froxlor/panel

IMAGE                  ID             DISK USAGE   CONTENT SIZE   EXTRA
froxlor/panel:2.3.16   0592cfb2a308       1.02GB          249MB   U    

docker compose up -d

 Network froxlor-2316-stack_froxlor-net Creating 
 Network froxlor-2316-stack_froxlor-net Created 
 Container froxlor-2.3.16-db Creating 
 Container froxlor-2.3.16-db Created 
 Container froxlor-2.3.16-panel Creating 
 Container froxlor-2.3.16-panel Created 
 Container froxlor-2.3.16-db Starting 
 Container froxlor-2.3.16-db Started 
 Container froxlor-2.3.16-db Waiting 
 Container froxlor-2.3.16-db Healthy 
 Container froxlor-2.3.16-panel Starting 
 Container froxlor-2.3.16-panel Started 

docker compose ps

NAME                   IMAGE                  COMMAND                  SERVICE   CREATED          STATUS                    PORTS
froxlor-2.3.16-db      mariadb:10.11          "docker-entrypoint.s…"   db        11 seconds ago   Up 11 seconds (healthy)   3306/tcp
froxlor-2.3.16-panel   froxlor/panel:2.3.16   "/usr/local/bin/entr…"   froxlor   11 seconds ago   Up 6 seconds              0.0.0.0:8141->80/tcp, [::]:8141->80/tcp

{
    "mysql_host": "db",
    "mysql_ssl_ca_file": "",
    "mysql_ssl_verify_server_certificate": "0",
    "mysql_root_user": "froxroot",
    "mysql_root_pass": "q1w2e3r4",
    "mysql_unprivileged_user": "froxlor",
    "mysql_unprivileged_pass": "q1w2e3r4",
    "mysql_database": "froxlor",
    "mysql_force_create": "1",
    "admin_name": "Administrator",
    "admin_user": "admin",
    "admin_pass": "q1w2e3r4",
    "admin_pass_confirm": "q1w2e3r4",
    "admin_email": "admin@froxlor.test",
    "use_admin_email_as_sender": "1",
    "sender_email": "admin@froxlor.test",
    "distribution": "bookworm",
    "serveripv4": "10.89.68.10",
    "serveripv6": "",
    "servername": "panel.froxlor.test",
    "use_ssl": "0",
    "webserver": "apache24",
    "webserver_backend": "mod_php",
    "httpuser": "www-data",
    "httpgroup": "www-data",
    "activate_newsfeed": "0",
    "manual_config": "0"
}

docker compose cp install.json froxlor:/tmp/install.json
docker compose exec froxlor php /var/www/html/froxlor/bin/froxlor-cli froxlor:install /tmp/install.json

Froxlor installation
====================

 [INFO] Running unattended installation

System check
------------

 [INFO] Your system is running with PHP 8.2.35

 [WARNING] The following php extensions could not be found but are recommended

           zip
           gnupg

Create database and user
------------------------

 Setting field 'mysql_host' to value 'db'
 Setting field 'mysql_root_user' to value 'froxroot'
 ...
 Setting field 'mysql_database' to value 'froxlor'
 Setting field 'mysql_force_create' to value '1'

Let's create the main administrator user.
-----------------------------------------

 Setting field 'admin_user' to value 'admin'
 ...
Details about your server
-------------------------

 Setting field 'distribution' to value 'bookworm'
 Setting field 'serveripv4' to value '10.89.68.10'
 Setting field 'servername' to value 'panel.froxlor.test'
 Setting field 'webserver' to value 'apache24'
 Setting field 'webserver_backend' to value 'mod_php'

 [OK] Run the following command to finish the installation:

      /var/www/html/froxlor/bin/froxlor-cli froxlor:config-services -a
      '{"distro":"bookworm","dns":"x","http":"apache24","smtp":"postfix_dovecot"
      ,"mail":"dovecot_postfix2","antispam":"rspamd","ftp":"proftpd","system":["
      cron","libnssextrausers","logrotate","goaccess"]}' --yes-to-all

Creating missing certificate /etc/ssl/froxlor_selfsigned.pem

docker compose exec froxlor php /var/www/html/froxlor/bin/froxlor-cli \
  froxlor:config-services -a '{"distro":"bookworm","dns":"x","http":"apache24","smtp":"postfix_dovecot","mail":"dovecot_postfix2","antispam":"rspamd","ftp":"proftpd","system":["cron","libnssextrausers","logrotate","goaccess"]}' --yes-to-all

Creating missing certificate /etc/ssl/froxlor_selfsigned.pem
--- Configuring: HTTP ---
Configuring 'apache24'
Installing required packages
apache2 is already the newest version (2.4.69-1~deb13u1).
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
--- Configuring: DNS ---
Skipping DNS configuration as desired
--- Configuring: SMTP ---
Configuring 'postfix_dovecot'
Installing required packages
E: Unable to locate package postfix
E: Unable to locate package postfix-mysql
...
--- Configuring: MAIL ---
Configuring 'dovecot_postfix2'
E: Unable to locate package dovecot-imapd
...
--- Configuring: ANTISPAM ---
Configuring 'rspamd'
W: OpenPGP signature verification failed: https://rspamd.com/apt-stable bookworm InRelease: Sub-process /usr/bin/sqv returned an error code (1), error message is: Missing key 3FA347D5E599BE4595CA2576FFA232EDBF21E25E, which is needed to verify signature.
Installing required packages
The following NEW packages will be installed:
  ... rspamd ...
0 upgraded, 14 newly installed, 0 to remove and 1 not up
...
Setting up rspamd (3.12.1-1) ...
--- Configuring: FTP ---
Configuring 'proftpd'
...
Setting up proftpd-core (1.3.8.c+dfsg-4+deb13u3) ...
Creating file "/etc/proftpd/proftpd.conf"
...
sh: 1: /usr/bin/php: not found
All services have been configured

docker compose exec froxlor ln -sf /usr/local/bin/php /usr/bin/php

docker compose exec froxlor php /var/www/html/froxlor/bin/froxlor-cli froxlor:cron 'tasks' -f -d

Checking froxlor file permissions...OK
Running "tasks" job (forced) (debug)
[information] TasksCron: Searching for tasks to do
[notice] Creating passwd file
[notice] Writing 0 entries to passwd file
[notice] Succesfully wrote passwd file
[information] apache::createIpPort: creating ip/port settings for  10.89.68.10:80
[debug] 10.89.68.10:80 :: inserted vhostcontainer
[information] apache::writeConfigs: rebuilding /etc/apache2/sites-enabled/
[information] Froxlor\Cron\Http\Apache::reload: reloading Froxlor\Cron\Http\Apache
[notice] Checking system's last guid

curl -s -o /dev/null -w "GET / -> %{http_code} redirect=%{redirect_url}\n" http://127.0.0.1:8141/
curl -s -o /dev/null -c /tmp/fxj -w "POST index.php -> %{http_code} redirect=%{redirect_url}\n" \
  -X POST http://127.0.0.1:8141/index.php --data "loginname=admin&password=q1w2e3r4&redirect="
curl -s -b /tmp/fxj -o /tmp/fxdash -w "GET admin_index.php -> %{http_code}\n" http://127.0.0.1:8141/admin_index.php

GET / -> 200 redirect=
POST index.php -> 302 redirect=http://127.0.0.1:8141/admin_index.php
GET admin_index.php -> 200
<title>froxlor</title>

docker compose exec froxlor php /var/www/html/froxlor/bin/froxlor-cli froxlor:install -s

┌────────────────┬───────────────────────────┐
│ Key            │ Value                     │
├────────────────┼───────────────────────────┤
│ Froxlor        │ 2.3.16 (202608210)        │
│ Update-channel │ stable                    │
│ Hostname       │ panel.froxlor.test        │
│ Install-dir    │ /var/www/html/froxlor/    │
│ PHP CLI        │ 8.2.35                    │
│ PHP SAPI       │ mod_php                   │
│ Webserver      │ apache2                   │
│ Kernel         │ 7.0.0-38-generic (x86_64) │
│ Database       │ 10.11.19-MariaDB-ubu2204  │
│ Distro config  │ bookworm                  │
│ IP addresses   │ 10.89.68.10 (80)          │
└────────────────┴───────────────────────────┘

# automatically generated cron-configuration by froxlor
# do not manually edit this file as it will be re-generated periodically.
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
#
*/5 * * * * root /usr/bin/nice -n 5 /usr/bin/php -q /var/www/html/froxlor/bin/froxlor-cli froxlor:cron 'tasks' -q 1> /dev/null
0 0 * * * root /usr/bin/nice -n 5 /usr/bin/php -q /var/www/html/froxlor/bin/froxlor-cli froxlor:cron 'traffic' -q 1> /dev/null
5 0 * * * root /usr/bin/nice -n 5 /usr/bin/php -q /var/www/html/froxlor/bin/froxlor-cli froxlor:cron 'usage_report' -q 1> /dev/null
0 */6 * * * root /usr/bin/nice -n 5 /usr/bin/php -q /var/www/html/froxlor/bin/froxlor-cli froxlor:cron 'mailboxsize' -q 1> /dev/null

$sql = [
	'debug' => false,
	'host' => 'db',
	'user' => 'froxlor',
	'password' => 'q1w2e3r4',
	'db' => 'froxlor',
];
$sql_root = [
	'0' => [
		'caption' => 'Default',
		'host' => 'db',
		'user' => 'froxroot',
		'password' => 'q1w2e3r4',
	],
];

GET /  -> 403
POST /index.php -> 404
froxlor-2.3.16-panel  | [autoindex:error] AH01276: Cannot serve directory /var/www/html/: No matching DirectoryIndex (index.php,index.html) found, and server-generated directory index forbidden by Options directive

docker compose exec froxlor php /var/www/html/froxlor/bin/froxlor-cli \
  froxlor:config-services -a '{"distro":"bookworm","dns":"x","http":"apache24","smtp":"postfix_dovecot","mail":"dovecot_postfix2","antispam":"rspamd","ftp":"proftpd","system":["cron","libnssextrausers","logrotate","goaccess"]}' --yes-to-all
docker compose exec froxlor php /var/www/html/froxlor/bin/froxlor-cli froxlor:cron 'tasks' -f
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8141/

Reloading Apache httpd web server: apache2.
200

# compose.yml froxlor 服务 volumes 段的替代写法（二选一）
volumes:
  - ./userdata.inc.php:/var/www/html/froxlor/lib/userdata.inc.php:ro

docker run -d --name froxlor-run-demo \
  -v froxlor-run-demo-data:/var/www/html/froxlor \
  --network froxlor-2316-stack_froxlor-net -p 8142:80 \
  froxlor/panel:2.3.16

7fcb1fee02e7cb049f028378042f21c8d2d6fc08974430548c93abcf7d922dc3
run-demo 8142 GET / -> 403 redirect=

docker run --rm froxlor/panel:2.3.16 php /var/www/html/froxlor/bin/froxlor-cli --version

froxlor-cli 2.3.16

docker rm -f froxlor-run-demo && docker volume rm froxlor-run-demo-data

froxlor-run-demo
froxlor-run-demo-data