README

WPKG 的基于 Web 的前端

WPKG Express 2 基于 Brian White 的 wpkgExpress（©2009年）。

WPKG 是一个用于 Windows 的自动化软件部署、升级和卸载程序。

WPKG Express 2 用户界面

查看项目的 演示。

此 WPKG 前端提供以下功能

• 通过用户名和密码进行用户认证以及 LDAP 安全组成员资格；
• 生成 WPKG 的 XML 配置文件
  • packages.xml - 定义软件包（WPKG 安装/卸载程序的命令等）；
  • profiles.xml - 指定每个 WPKG 配置文件将安装/执行哪些包；
  • hosts.xml - 机器名与配置文件名之间的映射；
  • config.xml - wpkg.js 运行时行为的配置设置。
• 生成 Windows Post-Install Wizard 的配置文件
  • config.js - WPI 的配置文件；
  • profiles.xml - 指定每个 WPKG 配置文件将安装/执行哪些包；
  • hosts.xml - 机器名与配置文件名之间的映射；
  • config.xml - wpkg.js 运行时行为的配置设置。
• 根据模板创建包、配置文件和主机；
• 根据模板和 LDAP 中的计算机列表创建配置文件和主机；
• 创建包、配置文件和主机的副本；
• 使用验证 XML 架构预览 WPKG 的 XML 配置文件；
• 使用验证 XML 架构下载和上传 WPKG 的 XML 配置文件；
• 使用具有验证 XML 架构和基于 XML 架构的自动完成功能的编辑器创建和编辑 WPKG 的 XML 配置；
• 构建包、配置文件和主机的关系图；
• 按名称构建主机的关系图；
• 维护包的存档版本，并具有切换到版本的能力；
• 根据 LDAP 中的计算机列表禁用未使用的配置文件和主机；
• 解析 WPKG 日志文件，并将报告发送到管理员的电子邮件；
• 解析 WPKG 报告和客户端数据库文件；
• 查看已安装软件包的版本图表；
• 回收站，可以恢复包、配置文件或主机的已删除数据。

要求

• Apache 模块 mod_rewrite；
• PHP 5.4 或更高版本（高达 7.4）；
• PHP 扩展：pdo、ldap、bz2、xml 和 openssl；
• LDAP 服务器（Active Directory、Samba 或 OpenLDAP）进行身份验证（仅 Active Directory）和获取计算机列表以创建基于模板的 配置文件 和 主机；
• 数据库服务器（MySQL 或 Postgres）。

不必要

• 安装应用程序需要 Composer；
• 创建 包、配置文件 和 主机 的依赖关系图需要 GraphViz；
• 使用 smbclient 访问客户端计算机的日志文件和数据库以解析内容；
• SMTP 服务器向管理员发送邮件通知。

安装

1. 使用composer安装WPKG Express 2: composer create-project anklimsk/wpkg-express-2 /var/www/wpkg，其中/var/www/wpkg是Document Root目录。或者直接从发布页面下载最新版本，并将压缩文件解压到Document Root目录。
2. 为该域名设置DocumentRoot指令为/var/www/wpkg/app/webroot。
3. 确保允许.htaccess覆盖，并且将AllowOverride设置为All以正确设置DocumentRoot。对于使用apache 2.4及更高版本的用户，需要修改你的httpd.conf或虚拟主机配置文件，使其看起来如下所示

DocumentRoot /var/www/wpkg/app/webroot

<Directory /var/www/wpkg>
     Options FollowSymLinks
     AllowOverride All
     Require all granted
</Directory>

1. 如果你使用OPcache，你应该设置opcache.blacklist_filename配置值为你的黑名单文件路径（查看缓存）

• 例如，创建一个新文件：/etc/php/7.4/apache2/opcache-blacklist.txt；
• 指定排除文件的路径，例如：/var/www/wpkg/app/tmp/cache/views/wpkg_*.php；
• 将黑名单文件路径添加到你的php.ini文件中：opcache.blacklist_filename=/etc/php/7.4/apache2/opcache-blacklist.txt；
• 重新加载apache配置：sudo service apache2 reload。

1. 导航到应用目录app（/var/www/wpkg/app），并运行以下命令：sudo ./Console/cake CakeInstaller以启动安装器的交互式外壳。
2. 安装过程完成后，在浏览器中访问链接https://wpkg.fabrikam.com/settings以更改应用设置，其中https://wpkg.fabrikam.com是已安装WPKG Express 2的基本URL。
3. 填写Authentication组设置中的字段（如有需要）并点击保存按钮。

更新

更新前端到WPKG

使用

使用此前端来使用WPKG

链接

• 许多程序静默安装、升级和卸载配置的列表;
• 作为组策略扩展运行WPKG（forked from cleitet/wpkg-gp）;
• wpkg-gp的GUI.

项目图标

部分：WPKG标志由Eric Le Henaff提供

许可

GNU通用公共许可证版本3