快速上手

# 前言

本文档为金蝶Apusic负载均衡器软件V2.0.6标准版的使用说明，为用户介绍金蝶Apusic负载均衡器产品，帮助用户快速上手。

# 适用对象

本文档适用于IT信息化业务负责人、研发经理、软件项目经理、软件架构师、运维工程师。

# 相关文档

了解更多ALB V2.0.6产品相关的信息，请参阅以下ALB V2.0.6产品手册文档集：

序号	手册文档	说明
1	金蝶Apusic负载均衡器软件 V2.0.6 发版说明	介绍了ALB 产品版本更新内容。
2	金蝶Apusic负载均衡器软件 V2.0.6 快速使用手册	简单介绍了如何快速上手使用ALB 。
3	金蝶Apusic负载均衡器软件 V2.0.6 安装手册	详细介绍如何在各操作系统上安装ALB，以及ALB服务启停操作，产品的注册过程。
4	金蝶Apusic负载均衡器软件 V2.0.6 代理功能手册	详细介绍 ALB 相关功能的使用、配置、管理及配套工具的使用方法。
5	金蝶Apusic负载均衡器软件 V2.0.6 管控台用户手册	详细介绍ALB管控台相关功能的使用和操作说明。
6	金蝶Apusic负载均衡器软件 V2.0.6 开发手册	详细介绍ALB外部API、alb-cli命令行工具及AI Agent集成方法。
7	金蝶Apusic负载均衡器软件 V2.0.6 迁移手册	详细介绍ALB历史版本迁移升级到V2.0.6版本的说明。
8	金蝶Apusic负载均衡器软件 V2.0.6 运维手册	详细介绍ALB的监控、运维、安全加固等运维说明。
9	金蝶Apusic负载均衡器软件 V2.0.6 性能优化手册	详细介绍ALB性能调优的说明。

# 技术支持

ALB产品提供全面的技术支持服务，您可以通过以下方式获得技术支持：

网址：www.apusic.com
电话：400-855-5800
邮箱：support@apusic.com
金蝶云社区：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技术支持时，请提供如下信息：

您的姓名
公司信息与联系方式
操作系统及其版本
产品版本号
出现异常及错误的日志、截图等详细信息

# 版本更新说明

本文根据实际情况进行更新，最新版本包含历史修改记录。

日期	手册版本	适用产品	更新说明
2024年12月	V2.0.2	ALB V2.0.2 敏捷版	修改ALB高可用和授权认证使用文档
2025年08月	V2.0.5	ALB V2.0.5 标准版	新版用户手册，新增管控台使用说明
2026年06月	V2.0.6	ALB V2.0.6 标准版	全新升级管控台

# 快速入门

产品使用前需切换进入到ALB安装目录，示例为 /opt/ALB-V2.0.6-SE-20260421-amd64（实际目录名以安装包解压后为准），并将申请的ALB标准版授权文件（license.lic、license.xml 或统一授权配置文件 acls.properties）放入到安装目录下。

注意：若授权文件缺失或无效，ALB 启动会失败并提示授权错误，请确保授权文件已正确放置。

# 第一次启动

ALB标准版第一次启动管控台的时候会生成多个管理用户的初始随机密码，请登录控制台后及时修改。

./bin/start-alb-and-console.sh
ALB is Starting(正在启动ALB)...
alb: [emerg] : KBC auth: license just for test
      ___                     _        金蝶Apusic负载均衡器软件标准版
     /   |  ____  __  _______(_)____   Edition: Standard Edition
    / /| | / __ \/ / / / ___/ / ___/   License start: 2026-03-16 00:00:00
   / ___ |/ /_/ / /_/ (__  ) / /__     License end: 2026-06-30 23:59:59
  /_/  |_/ .___/\__,_/____/_/\___/     IP granted: 255.255.255.255
        /_/                            Licensee: 深圳市金蝶天燕云计算股份有限公司

  version: v2.0.6

ALB console is starting (正在启动ALB控制台)...

========================================
ALB Console 默认用户初始密码
========================================
  admin-system: &H3vYJGS65tm@IZk
  admin-security: n9dzFv2U1i&d65C*
  admin-audit: 0J@Ra^ot3VVrtClx
  admin-alb: ^K4gJ05^htPUVbtK
  user-alb: Q27&E^HfVGU*Q1Io

安全提示: 首次登录后请立即修改密码
========================================

ALB and its console are running now!(ALB和ALB控制台启动成功)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

初始化后的管控台用户和密码会显示在控制台的初始化信息中，请登录控制台进行修改。

忘记查看初始密码，可通过文件 console/data/users/.init_passwords 查看

cat console/data/users/.init_passwords
# ALB Console 默认用户初始密码
# 本文件由系统自动生成,请勿手动修改
# 生成时间: 2026-06-22 17:46:23

admin-system: &H3vYJGS65tm@IZk
admin-security: n9dzFv2U1i&d65C*
admin-audit: 0J@Ra^ot3VVrtClx
admin-alb: ^K4gJ05^htPUVbtK
user-alb: Q27&E^HfVGU*Q1Io

# 安全提示:首次登录后请立即修改密码,并删除本文件

1
2
3
4
5
6
7
8
9
10
11
12

# 登录管控台

登录地址： http://【部署节点IP】:8887（系统管理员、普通用户）；http://【部署节点IP】:8887/admin（安全管理员、审计管理员）
登录用户：admin-alb
密码：请根据第一次启动输出的初始密码进行登录（若未记录，可通过 console/data/users/.init_passwords 文件查看）

登录成功后，第一次登录必须强制修改密码：

登录成功后进入首页

# 配置反向代理

步骤如下：

准备需要进行反向代理的目标服务器IP和服务端口。
在管控台站点管理中创建站点，配置监听端口和反向代理到目标服务器。
验证反向代理测试。

例子：现在有个HTTP服务： 192.168.1.100:8080，需要通过alb代理发布内容，在alb节点可以正常访问该服务，则可以通过配置alb的反向代理实现代理HTTP服务。

目标代理服务： 192.168.1.100:8080
在管控台站点管理中创建站点，配置监听端口和反向代理到目标服务器。
验证反向代理测试。

curl http://[ALB-IP]:8080

# 配置代理静态资源

步骤如下：

准备静态资源文件目录，压缩到zip包
在ALB管控台中创建HTTP站点
填写完HTTP站点名称和端口后，切换到Location配置
点击添加Location按钮
选择静态资源，点击上传静态资源包
点击保存

验证静态资源测试。

curl http://[ALB-IP]:8080/index.html

# 配置动静分离

目标需求：默认路径访问静态资源，API接口反向代理到后端。

步骤如下：

准备静态资源文件目录，压缩到zip包
在ALB管控台中创建HTTP站点
填写完HTTP站点名称和端口后，切换到Location配置
点击添加Location按钮
选择静态资源，点击上传静态资源包

点击添加Location按钮
类型选择反向代理，路径填写/api/，代理地址为后端服务地址

点击保存

# 获取静态资源index.html
curl http://[ALB-IP]:8080/index.html
# 请求api
curl http://[ALB-IP]:8080/api/user/list

1
2
3
4

# 产品启动和配置说明

# 产品启动、停止、热加载、卸载、验证配置文件和获取授权码

启动ALB实例和管理控制台

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./bin/start-alb-and-console.sh                   # 启动alb和管理控制台

1
2

启动ALB实例，但不启动管控台

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./bin/start-alb.sh                   # 启动alb

1
2

停止ALB实例和管理控制台

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./bin/stop-alb-and-console.sh                    # 停止alb和管理控制台

1
2

停止ALB实例

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./bin/stop-alb.sh                    # 停止alb

1
2

热加载

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./bin/reload-alb.sh                  # 热加载alb配置

1
2

卸载
- 解压安装包
  - 直接删除安装目录
- rpm：
  - x86: rpm -e ALB-SE-2.0.6-1.el7.x86_64
  - arm64: rpm -e ALB-SE-2.0.6-1.el7.aarch64
验证配置文件

可以使用-t参数验证配置文件的配置是否存在错误

验证成功提示：syntax is ok和test is successful

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./sbin/alb -t                          # 验证conf/alb.conf配置文件是否存在语法错误

1
2

验证指定的配置文件，可以通过-c参数指定配置文件

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./sbin/alb -t -c conf/alb.conf         # 指定验证conf/alb.conf配置文件是否存在语法错误

# 输出
alb:the configuration file /opt/ALB-V2.0.6-SE-amd64/conf/alb.conf syntax is ok
alb:configuration file /opt/ALB-V2.0.6-SE-amd64/conf/alb.conf test is successful

1
2
3
4
5
6

产品获取授权码

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
./bin/alb-authcode                 # 获取alb在当前节点的授权码
# 注： 如果出现多个授权码，选择任意一个授权码申请授权文件即可

./bin/alb-authcode -ac eth0              # 获取指定网卡的授权码
./bin/alb-authcode -ac 192.168.1.150     # 获取指定IP的授权码

1
2
3
4
5
6

配置 systemd 自启动（可选）

ALB 安装包 utils/systemd/ 目录下提供了 systemd 服务文件，可将其注册为系统服务并设置开机自启：

cd /opt/ALB-V2.0.6-SE-amd64            # 进入安装目录
cp utils/systemd/alb.service /etc/systemd/system/alb.service
systemctl daemon-reload
systemctl enable alb
systemctl start alb

1
2
3
4
5

# 产品配置

ALB 核心兼容Nginx配置，主配置文件路径为：

安装路径/conf/alb.conf

一个简单的 alb.conf 示例如下：

user nobody;
worker_processes auto;

events {
    worker_connections 1024;
}

http {
    server {
        listen 8080;
        server_name localhost;

        location / {
            proxy_pass http://192.168.1.100:8080;
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

可使用Nginx的配置方式及其配置内容进行配置ALB，可在管控台配置管理中，直接编辑修改对应配置文件

编辑页面

← 发版说明安装手册→