Maloja项目使用与配置指南

Maloja项目使用与配置指南

maloja Self-hosted music scrobble database to create personal listening statistics and charts 项目地址: https://gitcode.com/gh_mirrors/ma/maloja

1. 项目目录结构及介绍

Maloja项目的目录结构如下：

• auxiliary/：包含辅助脚本和文件。
• container/：包含Docker容器相关文件。
• dev/：开发相关的文件和目录。
• .github/：GitHub Actions工作流和配置文件。
• etc/：配置文件和脚本。
• s6-overlay/：用于服务的s6管理脚本。
• s6-rc.d/：s6的运行控制脚本。
• maloja/：Maloja主应用程序代码。
• requirements.txt：项目依赖的Python库。
• requirements_extra.txt：额外依赖的Python库。
• DEVELOPMENT.md：开发文档。
• FUTURE.md：未来功能规划。
• LICENSE：项目许可证。
• README.md：项目说明文件。
• settings.md：项目配置说明。

2. 项目的启动文件介绍

项目的启动主要通过Docker容器进行。以下是一个基本的启动命令示例：

docker run -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata krateng/maloja

该命令会启动Maloja容器，并将容器的42010端口映射到宿主机的42010端口，同时将当前目录下的malojadata文件夹挂载到容器内的/mljdata目录。

如果使用rootless容器或Podman，可能需要设置用户和用户组ID：

docker run -e PUID=1000 -e PGID=1001 -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata krateng/maloja

3. 项目的配置文件介绍

Maloja的主要配置文件是/etc/maloja/settings.ini。在这个文件中，你可以设置各种参数，例如：

• MALOJA_SKIP_SETUP：跳过非交互式设置。
• MALOJA_FORCE_PASSWORD：设置管理员密码。
• MALOJA_DATA_DIRECTORY：设置数据目录。

此外，还可以通过环境变量进行配置，如MALOJA_前缀的环境变量会被Maloja识别。

你还可以在apikeys.yml文件中设置API密钥，以及在rules.info文件中指定自定义规则。在images.info文件中管理自定义图片。所有这些配置都可以在Maloja的Web界面的管理员设置中进行修改。

maloja Self-hosted music scrobble database to create personal listening statistics and charts 项目地址: https://gitcode.com/gh_mirrors/ma/maloja