davorg/perl-perlanet

perl-perlanet-docker 镜像文档

镜像概述

perl-perlanet-docker是一个预装了Perl运行环境和Perlanet工具的Docker镜像。Perlanet是一款基于Perl的RSS/Atom订阅源聚合工具，能够将多个订阅源内容整合为单一feed。本镜像旨在简化Perlanet的部署流程，用户可直接使用，无需手动配置Perl环境及安装Perlanet依赖。

核心功能和特性

• 预装环境：包含完整Perl运行环境及Perlanet工具，无需额外安装
• 即开即用：省去环境配置步骤，拉取镜像后可直接运行Perlanet命令
• 轻量便捷：基于官方Perl基础镜像构建，保持较小体积同时确保功能完整
• 兼容性好：支持Perlanet的标准配置及扩展功能

使用场景和适用范围

• 快速聚合服务：个人或小型团队需快速搭建RSS/Atom订阅源聚合服务的场景
• 开发测试：开发者测试Perlanet功能或调试自定义订阅源聚合逻辑
• 原型验证：验证基于Perlanet的订阅源聚合应用原型
• 自动化部署：集成到CI/CD流程，实现订阅源聚合服务的自动化部署

使用方法和配置说明

获取镜像

假设镜像已构建并命名为perl-perlanet，可通过以下命令拉取（实际使用时需替换为正确的镜像仓库地址）：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/perl-perlanet

基本使用

Perlanet需通过配置文件定义聚合规则，基本使用步骤如下：

1. 准备Perlanet配置文件
   创建本地配置文件（如perlanet_config.pl），示例内容：

   perl
   # perlanet_config.pl示例
   {
       title => 'My Aggregated Feed',
       url   => 'http://example.com/feed',
       feeds => [
           'http://example.com/feed1.rss',
           'http://example.com/feed2.atom',
       ],
       output => 'aggregated_feed.xml',
   }
   

2. 运行容器
   通过docker run命令启动容器，挂载本地配置文件到容器内，并指定Perlanet执行命令：

   bash
   docker run -v $(pwd)/perlanet_config.pl:/app/perlanet_config.pl docker.xuanyuan.run/[镜像仓库地址]/perl-perlanet perlanet /app/perlanet_config.pl
   

   • -v $(pwd)/perlanet_config.pl:/app/perlanet_config.pl：将本地配置文件挂载到容器内/app目录
   • perlanet /app/perlanet_config.pl：执行Perlanet命令，使用挂载的配置文件生成聚合feed

高级配置

• 输出文件持久化：如需保存聚合后的feed文件，可挂载输出目录：

  bash
  docker run -v $(pwd)/config:/app/config -v $(pwd)/output:/app/output docker.xuanyuan.run/[镜像仓库地址]/perl-perlanet perlanet /app/config/perlanet_config.pl --output /app/output/aggregated_feed.xml
  

• 自定义Perlanet参数：支持传递Perlanet的其他命令行参数（如--verbose启用详细日志）：

  bash
  docker run -v $(pwd)/perlanet_config.pl:/app/perlanet_config.pl docker.xuanyuan.run/[镜像仓库地址]/perl-perlanet perlanet --verbose /app/perlanet_config.pl
  

注意事项

• 确保本地配置文件格式符合Perlanet要求（Perl哈希格式）
• 如需使用Perlanet的扩展功能（如自定义模板），需在配置文件中指定相关路径，并通过-v参数挂载对应文件到容器内
• 基础镜像版本及Perlanet版本信息请参考镜像构建时的Dockerfile