woahbase/alpine-akaunting

镜像概述

该镜像容器化了Akaunting会计Web应用及其PHP依赖，适用于个人或小团队的财务指标跟踪（不含数据库，建议搭配alpine-mysql镜像使用）。基于Alpine Linux，集成Nginx、PHP7和s6初始化系统，支持x86_64（标记为latest）与armhf架构，自动同步GitHub发布版本更新。

核心功能

• 提供Akaunting会计Web应用服务
• 支持静态文件托管（通过Nginx）
• 可配置PUID/PGID实现降权运行
• 绑定HTTP(80)和HTTPS(443)端口
• 首次运行自动生成4096位自签名SSL证书
• 提供带认证的安全访问路径/secure
• 支持跨架构运行（需配置binfmt_misc）

使用场景

• 个人日常财务记录与跟踪
• 小团队简易财务指标管理
• 轻量级会计服务部署场景（需独立配置数据库）

配置说明

• Akaunting访问端点：/akaunting/，应用目录：/config/akaunting/
• 源码包位置：/opt/akaunting/akaunting.zip
• Nginx继承配置：
  • 支持降权至alpine用户，尊重PUID/PGID参数
  • 默认静态站点根目录：/config/www/，挂载/config/可持久化修改
  • SSL证书生成路径：/config/keys，可通过SSLSUBJECT变量自定义证书信息
  • 默认认证凭据：admin/insecurebydefault（存储于/config/keys/.htpasswd）
  • 安全路径/secure需HTTPS与认证双重验证

Docker部署示例

拉取镜像

bash
docker pull woahbase/alpine-akaunting:x86_64

运行容器

bash
docker run --rm -it \
  --name docker_akaunting --hostname akaunting \
  -e PGID=1000 -e PUID=1000 \
  -c 256 -m 256m \
  -p 80:80 -p 443:443 \
  -v config:/config \
  -v /etc/hosts:/etc/hosts:ro \
  -v /etc/localtime:/etc/localtime:ro \
  woahbase/alpine-akaunting:x86_64

容器管理

停止容器

bash
docker stop -t 2 docker_akaunting

删除容器

bash
docker rm -f docker_akaunting

重启容器

bash
docker restart docker_akaunting

交互操作

普通用户Shell

bash
docker exec -it docker_akaunting /bin/bash

Root用户Shell

bash
docker exec -u root -it docker_akaunting /bin/bash

实时日志查看

bash
docker logs -f docker_akaunting

开发与构建

环境准备

需安装Git、GNU Make和Docker，克隆仓库：

bash
git clone https://github.com/woahbase/alpine-akaunting
cd alpine-akaunting

本地构建（x86_64架构）

bash
docker build --rm --compress --force-rm \
  --no-cache=true --pull \
  -f ./Dockerfile_x86_64 \
  --build-arg ARCH=x86_64 \
  --build-arg DOCKERSRC=alpine-php \
  --build-arg PGID=1000 \
  --build-arg PUID=1000 \
  --build-arg USERNAME=woahbase \
  -t woahbase/alpine-akaunting:x86_64 \
  .

测试镜像

bash
docker run --rm -it \
  --name docker_akaunting --hostname akaunting \
  -e PGID=1000 -e PUID=1000 \
  woahbase/alpine-akaunting:x86_64 \
  sh -ec 'nginx -v; php --version; echo "$(cat /opt/akaunting/version)";'

推送镜像（需权限）

bash
docker push woahbase/alpine-akaunting:x86_64