安装KodeFlex
1. KodeFlex介绍
1.1 关于KodeFlex
2. 安装KodeFlex
2.1 Windows一键安装包
2.2 Linux一键安装包
2.3 使用源码包安装(各系统通用)
2.4 安装ZAI服务
3. 升级KodeFlex
3.1 升级前备份
3.2 Windows一键包升级
3.3 Linux一键包升级
3.4 源码包升级
4. 平台功能
4.1. 应用管理
4.1.1 创建应用
4.1.2 维护应用
4.2. 应用实例管理
4.2.1 实例管理
4.2.2 导航菜单
4.2.3 数据源
4.2.4 验证规则
4.2.5 审批流
4.3. 模块设计
4.3.1 关于模块
4.3.2 主表设计
4.3.3 子表设计
4.3.4 动作设计
4.3.5 标签设计
4.3.6 更多设置
4.3.7 发布停用模块
4.4. 用户管理
4.4.1 维护用户
4.4.2 维护部门
4.5. 权限管理
4.5.1 维护权限
4.6. 系统设置
4.6.1 公司
4.6.2 AI
4.6.3 备份
4.6.4 授权信息
4.6.5 安全
4.6.6 定时
4.6.7 时区
4.6.8 LDAP
5. 业务应用
5.1 访问应用
5.2. 应用后台
5.2.1 人员管理
5.2.2 权限管理

Linux一键安装包

2026-07-21 16:03:51
haoyonghong
143
最后编辑：haoyonghong 于 2026-07-23 09:41:09
分享链接

目录

Linux一键安装包内置了Apache、PHP、MySQL服务，不需要再单独安装。

一、安装

1.1 将安装包直接解压到/opt目录下

cd /opt
tar xvzf kodeflex.{最新版本号}.zbox_64.tar.gz

特别说明：

  • 不要解压到别的目录再拷贝到/opt/，因为这样会导致文件的所有者和读写权限改变
  • 不要解压后把整个目录777权限。

1.2 Apache和MySQL常用命令

  • 启动所有服务：/opt/zbox/zbox start
  • 停止所有服务：/opt/zbox/zbox stop
  • 重启所有服务：/opt/zbox/zbox restart
  • 通过配置检查服务状态：/opt/zbox/zbox check

注：如果需要开机自动启动，可以把 /opt/zbox/zbox restart 加到操作系统的自启目录。

1.3 访问和登录KodeFlex

启动Apache和MySQL服务后，浏览器直接访问 http://kodeflex服务器ip:apache端口 即可访问和登录KodeFlex。

注意：

  • 如果网页无法访问，请先关闭KodeFlex所在电脑的防火墙和selinux再刷新网页访问试一下。
  • 使用云服务器请注意在安全组中开放apache使用端口
  • KodeFlex默认管理员帐号是 admin，密码 123456。

登录后，即可使用KodeFlex功能。具体的使用，请直接参考我们的使用手册文档。

1.4 其他参数

如果不加任何参数执行 /opt/zbox/zbox 会打印输出命令可用参数：

Usage: ./zbox {start|stop|status|check} [--aport=8080] [--mport=3307]

  • --aport参数 可以修改Apache的端口
  • --mport参数 可以修改Mysql的端口

例如（apache端口改为8080，mysql端口改为3307）：

/opt/zbox/zbox --aport 8080 --mport 3307 start
15:49:49 root@mini zbox → /opt/zbox/zbox --aport 8080 --mport 3307 start
 15:52:09.54 INFO  ==> Starting service with custom port,Apache port=8080, MySQL port=3307...
 15:52:09.57 INFO  ==> Stopping the apache service...
 15:52:10.68 INFO  ==> The apache service is stopped.
 15:52:10.69 INFO  ==> Starting apache service...
 15:52:10.76 INFO  ==> Stopping the mysql service...
 15:52:11.79 INFO  ==> MySQL stop successfully.
 15:52:11.80 INFO  ==> Starting mysql service...
 15:52:12.94 WARN  ==> XXD is running.
==============================================================
Service             Port           Status    Version   Comment
==============================================================
Apache              8080           running   2.4.57
PHP                 -              running   7.4.33    prefork
MySQL               3307           running   10.6.14   MariaDB
XXD                 11443 11444    running   7.2.2
==============================================================
Application         Version
==============================================================
kodeflex            1.0
adminer             4.8.1

二、如何访问数据库

2.1 网页登录数据库

KodeFlex数据库管理用的是adminer，但是为了安全，访问adminer的时候需要身份验证，需要运行 /opt/zbox/auth/adduser.sh来添加用户，如下命令：

# 进入脚本目录
cd /opt/zbox/auth
# 执行添加用户的脚本
bash adduser.sh
This tool is used to add user to access adminer
Account: admin  # 输入用户名
Password:       # 输入密码
Adding password for user admin

打开浏览器，输入 http://kodeflex服务器的ip:apache端口 点击“数据库管理”：

弹窗验证是输入运行 addusers.sh添加的用户名和密码：

image-20230811155828457

我加的用户名是admin，密码是admin!@#。那么授权页面里用户名和密码就填写admin和admin!@#。

网页直接显示登录界面：

  • 系 统：默认选择MySQL。
  • 服务器：127.0.0.1:MySQL端口 （MySQL端口启用的是3307，那么就填写127.0.0.1:3307。注意：ip只能写127.0.0.1）
  • 用户名： root（KodeFlex默认的数据库用户名是root）
  • 密 码：123456（KodeFlex默认的数据库密码是123456）
  • 数据库：kodeflex。

导入数据：

2.2 命令行连接数据库

登录数据库：/opt/zbox/bin/mysql -u root -P MySQL端口 -p （如：/opt/zbox/bin/mysql -u root -P 3306 -p）

导入数据库：/opt/zbox/bin/mysql -u root -P MySQL端口 -p 要导入的库名 < XXXX.sql （如：/opt/zbox/bin/mysql -u root -P 3306 -p kodeflex< kodeflex.sql）

三、查看服务状态

执行 /opt/zbox/zbox status 可以查看当前服务状态和版本信息，如下：

/opt/zbox/zbox  status
 16:06:15.41 INFO  ==> Checking service status...
==============================================================
Service             Port           Status    Version   Comment
==============================================================
Apache              8080           running   2.4.57
PHP                 -              running   7.4.33    prefork
MySQL               3307           running   10.6.14   MariaDB
XXD                 11443 11444    running   7.2.2
==============================================================
Application         Version
==============================================================
kodeflex            1.0
adminer             4.8.1

四、其他说明

4.1 日志压缩与清理

Linux一键安装包（免安装版）默认对Apache的访问日志和错误日志按天进行压缩，但不会定期清理，请更加需要添加定时任务，维护压缩的日志文件。

Apache日志压缩的配置参见：/opt/zbox/etc/apache/httpd.conf

4.2 一键安装包目录结构说明

一键安装包的根目录有README 文件，里面详细的介绍了目录结构及功能。

4.3 配置文件

一键安装包首次启动时，会在根目录创建一个 .env 文件，这个文件中保存了一些初始配置，你可以根据情况更改这些配置，以下是关于配置的说明：

# Apache 主机地址，如果用外部Web服务，需要手动修改
export APACHE_HOST=127.0.0.1
# Aapche 端口号，通过--aport参数修改
export APACHE_PORT=80
# MySQL 主机地址，如果用外部MySQL，需要手动修改
export MYSQL_HOST=127.0.0.1
# MySQL 端口号，通过--mport参数修改
export MYSQL_PORT=3306
# MySQL 密码，如果手动更改后，需要修改这个配置
export MYSQL_PASS=123456
# 服务的默认用户，不要修改
export DEFAULT_USER="nobody"
# 服务的默认用户组，不要修改
export DEFAULT_GROUP="nogroup"
# 是否启用内置MySQL服务
export MYSQL_SERVICE=enabled
# 是否启用内置Apache服务
export APACHE_SERVICE=enabled
# 设置PATH变量
export PATH=$PATH:/opt/zbox/bin
如果用户做了修改，升级后不会覆盖配置，而且还会把新增的配置项添加到已有的配置文件中。

如果在.env中开启（enabled）或者禁用（disabled）了某些服务，需要通过 /opt/zbox/zbox check 使配置立即生效。