CodeMeter Linux 部署与配置指南
WIBU
2026-08-18
一、资源获取
CodeMeter 的 Linux 安装程序仅线上分发。请访问 Wibu-Systems 开发者中心获取最新版本安装包:
下载地址:Wibu-Systems 开发者软件下载中心
二、CodeMeter 组件说明
Linux 环境下 CodeMeter 提供四类核心组件,适配运行、开发、程序加密场景:
-
CodeMeter Runtime(运行环境)
包含终端用户访问 CmContainer 的全部核心文件:CodeMeter 守护进程 CodeMeterLin、CodeMeter 控制中心、动态链接库、CmDongle 加密狗 USB 热插拔驱动。
提供 32/64 位 x86 完整版;针对无图形界面的服务器 / 嵌入式设备,单独提供轻量包 CodeMeter Lite(仅驱动,不含 GUI 控制中心)。 -
CodeMeter SDK(软件开发工具包)
开发所需头文件、API 文档、配套工具(CmBoxPgm、CodeMeter License Editor、API 使用手册);安装前置依赖:必须先部署 CodeMeter Runtime。ARM 架构仅提供 lite 配套开发包,无完整版 SDK。 -
AxProtector SDK(应用加密开发包)
部署在开发主机,用于对程序做加密授权保护;仅支持 x86 32/64 位架构,ARM 平台无此套件。 -
AxProtector Runtime(可选运行环境)
可选组件,用于运行经 AxProtector 加密的程序(脚本、.NET 程序),内置 CPSRT 授权运行库;仅 x86 架构可用。
三、系统要求与兼容性矩阵
不同架构、包管理体系的最低系统基线:
| 架构 / 平台 | 包格式 | 最低 GLIBC 版本 | 最低内核版本 | 配套安装包限制 |
| 32 位 x86 | RPM / DEB | 2.17 | 3.x | 完整版 Runtime/Lite、SDK、AxProtector 全套可用 |
| 64 位 AMD64 (x86_64) | RPM / DEB | 2.17 | 3.x | 完整版 Runtime/Lite、SDK、AxProtector 全套可用 |
| 32 位 ARMHF | 仅 DEB | 2.13 | 4.9 | 仅提供 CodeMeter Lite 与 lite 开发包,无完整版 Runtime、无 AxProtector 套件 |
| 64 位 ARM64 | 仅 DEB | 2.17 | 4.15 | 仅提供 CodeMeter Lite 与 lite 开发包,无完整版 Runtime、无 AxProtector 套件 |
包命名规范(安装时替换 [版本号].[构建号] 为实际下载包数值)
- RPM 系列(RedHat/CentOS/SUSE/Fedora)
-
完整版 Runtime:
CodeMeter-[版本号].[构建号].i386.rpm/CodeMeter-[版本号].[构建号].x86_64.rpm -
Lite 轻量 Runtime:
CodeMeter-lite-[版本号].[构建号].i386.rpm/CodeMeter-lite-[版本号].[构建号].x86_64.rpm -
SDK 开发包:
CodeMeter-devel-[版本号].[构建号].i386.rpm/CodeMeter-devel-[版本号].[构建号].x86_64.rpm -
AxProtector SDK:
AxProtector-devel-[版本号].[构建号].i386.rpm/AxProtector-devel-[版本号].[构建号].x86_64.rpm -
AxProtector Runtime:
AxProtector-[版本号].[构建号].i386.rpm/AxProtector-[版本号].[构建号].x86_64.rpm
- DEB 系列(Debian/Ubuntu)
-
完整版 Runtime:
codemeter_[版本号].[构建号]_i386.deb/codemeter_[版本号].[构建号]_amd64.deb -
Lite 轻量 Runtime:
codemeter-lite_[版本号].[构建号]_i386.deb/codemeter-lite_[版本号].[构建号]_armhf.deb/codemeter-lite_[版本号].[构建号]_arm64.deb -
SDK 开发包:
codemeter-dev_[版本号].[构建号]_i386.deb/codemeter-dev_[版本号].[构建号]_amd64.deb -
ARM 开发包:
codemeter-lite-dev_[版本号].[构建号]_armhf.deb/codemeter-lite-dev_[版本号].[构建号]_arm64.deb -
AxProtector SDK:
axprotector-dev_[版本号].[构建号]_i386.deb/axprotector-dev_[版本号].[构建号]_amd64.deb -
AxProtector Runtime:
axprotector_[版本号].[构建号]_i386.deb/axprotector_[版本号].[构建号]_amd64.deb
四、安装步骤
⚠️ 重要前置约束:
-
安装 SDK、AxProtector 相关套件前,必须先安装 CodeMeter Runtime;颠倒安装顺序会触发依赖缺失,安装直接失败。
-
所有安装命令需 root 权限,前缀添加 sudo 或切换至 root 用户执行。
-
ARM 架构仅可安装 Lite 系列包,不支持完整版 Runtime、AxProtector 套件。
4.1 RPM 发行版(SUSE / RedHat / CentOS / Fedora)
以 64 位 x86_64 系统为例,32 位系统替换 x86_64 为 i386:
- 安装 Runtime(完整版,无 GUI 服务器替换为 lite 包)
bash rpm -ivh CodeMeter-[版本号].[构建号].x86_64.rpm
- (开发环境可选)安装 CodeMeter SDK
bash rpm -ivh CodeMeter-devel-[版本号].[构建号].x86_64.rpm
- (加密开发可选)安装 AxProtector SDK
bash rpm -ivh AxProtector-devel-[版本号].[构建号].x86_64.rpm
- (运行加密程序可选)安装 AxProtector Runtime
bash rpm -ivh AxProtector-[版本号].[构建号].x86_64.rpm
4.2 DEB 发行版(Debian / Ubuntu)
以 64 位 amd64 系统为例,32 位替换 amd64 为 i386;ARM 设备替换为 armhf/arm64 lite 包:
- 安装 Runtime(完整版,无头服务器替换为 lite 包)
bash dpkg -i codemeter_[版本号].[构建号]_amd64.deb
- (开发环境可选)安装 CodeMeter SDK
bash dpkg -i codemeter-dev_[版本号].[构建号]_amd64.deb
- (加密开发可选)安装 AxProtector SDK
bash dpkg -i axprotector-dev_[版本号].[构建号]_amd64.deb
- (运行加密程序可选)安装 AxProtector Runtime
bash dpkg -i axprotector_[版本号].[构建号]_amd64.deb
五、服务端与网络配置
前置说明
-
默认安装后,授权服务、Web 管理页面仅本机localhost可访问;对外开放需手动配置并放行防火墙端口。
-
端口清单:
-
网络授权服务 TCP:22350
-
WebAdmin HTTP TCP:22352
-
WebAdmin HTTPS TCP:22353
- 服务管理两套命令:
-
老式 SysVinit 系统(CentOS6、Ubuntu14 及更早):
/etc/init.d/codemeter、/etc/init.d/codemeter-webadmin -
systemd 现代系统(CentOS7+、Ubuntu16.04+):
systemctl start/stop/restart codemeter、systemctl start/stop/restart codemeter-webadmin
- 补充区分:
launchctl为 macOS 专属服务管理命令,Linux 系统不支持,请勿执行;Linux 配置文件固定路径/etc/wibu/CodeMeter/Server.ini,无 com.wibu. 前缀文件名。
配置 1:开启局域网授权服务器(端口 22350,允许其他设备借用本机许可证)
方式 1:WebAdmin 图形界面(本地浏览器访问)
打开本地 WebAdmin,进入 Settings | Server | Server Access,勾选启用网络服务器,保存配置。
方式 2:命令行修改配置文件
- 停止授权服务
# SysVinit
/etc/init.d/codemeter stop
# systemd
systemctl stop codemeter
- 编辑配置文件
vi /etc/wibu/CodeMeter/Server.ini
-
在
[General]段落新增 / 修改参数:IsNetworkServer=1,保存退出 -
重启授权服务
# SysVinit
/etc/init.d/codemeter start
# systemd
systemctl start codemeter
- 防火墙放行 22350 端口,否则外部设备无法连接授权服务。
配置 2:开启 WebAdmin 远程访问(端口 22352/22353,外网 / 局域网远程管理授权)
参数说明:RemoteRead 控制 WebAdmin 访问范围,RemoteRead=1 仅本地,RemoteRead=2 允许全网远程访问。
方式 1:WebAdmin 图形界面
本地 WebAdmin 进入 Settings | Basic | WebAdmin,选择 HTTP/HTTPS 协议,开启远程访问并设置账号验证,保存。
方式 2:命令行修改配置文件
- 同时停止授权服务与 WebAdmin 服务(两项必须全部停止)
# SysVinit
/etc/init.d/codemeter stop
/etc/init.d/codemeter-webadmin stop
# systemd
systemctl stop codemeter
systemctl stop codemeter-webadmin
- 编辑配置文件
vi /etc/wibu/CodeMeter/Server.ini
-
在
[HTTP]段落修改:RemoteRead=2,保存文件 -
依次重启两项服务
# SysVinit
/etc/init.d/codemeter start
/etc/init.d/codemeter-webadmin start
# systemd
systemctl start codemeter
systemctl start codemeter-webadmin
- 防火墙放行 22352、22353 端口,远程设备才可打开 Web 管理页面。
六、卸载指南
仅执行基础 Runtime 卸载会残留 SDK、AxProtector 开发库,多组件环境需逐条卸载:
6.1 RPM 发行版卸载
- 卸载 AxProtector 套件(如有安装)
rpm -e AxProtector-devel
rpm -e AxProtector
- 卸载 CodeMeter SDK(如有安装)
rpm -e CodeMeter-devel
- 卸载主运行环境
rpm -e CodeMeter
6.2 DEB 发行版卸载
- 卸载 AxProtector 套件(如有安装)
dpkg -r axprotector-dev
dpkg -r axprotector
- 卸载 CodeMeter SDK(ARM 为 lite-dev)
dpkg -r codemeter-dev
- 卸载主运行环境(ARM 为 codemeter-lite)
dpkg -r codemeter
七、后续学习指引
部署完成后,如需深度使用可查阅官方文档了解更多内容。