跳到主要内容

常用命令参考

本文档提供微搭低代码平台的常用命令参考,包括平台管理、服务控制和故障排除等操作。

1. 平台管理命令

1.1 版本升级

版本兼容性

以下升级命令适用于 v1.0.2-20241210 及后续版本

# 默认安装和续期操作
./install.sh

# 升级到最新版本
./install.sh --upgrade

# 升级到指定版本
./install.sh --upgrade=v1.0.2-20241210

参数说明:

  • 无参数:执行默认的安装和续期操作
  • --upgrade:升级到最新可用版本
  • --upgrade=<version>:升级到指定版本号

1.2 服务重启

根据版本选择对应的重启命令:

# 适用于 20241230 之前的版本
./upgrade.sh

# 适用于 20241230 及之后的版本
./restart.sh
版本差异

请根据您的平台版本选择正确的重启命令,使用错误的命令可能导致服务异常。

1.3 服务卸载

# 进入安装目录
cd /data/tencent/weda

# 停止并删除所有服务容器
docker-compose --profile all down

1.4 数据清理

数据丢失警告

以下操作将永久删除所有平台数据,仅在需要完全重新安装时使用!

# 进入安装目录
cd /data/tencent/weda

# 删除配置和数据文件
rm -rf configs
rm -rf log
rm -rf storage
rm -f /etc/wedalet/config.yaml

删除内容说明:

  • configs:平台配置文件目录
  • log:日志文件目录
  • storage:存储数据目录
  • /etc/wedalet/config.yaml:系统配置文件

2. 安装器管理命令

2.1 日志查看

实时日志监控

# 实时查看安装器日志输出
journalctl -u wedalet -f

历史日志查询

# 查看最近 200 行日志
journalctl -u wedalet | tail -n 200

# 查看所有历史日志
journalctl -u wedalet

# 查看指定时间范围的日志
journalctl -u wedalet --since "2024-01-01" --until "2024-01-02"

# 查看今天的日志
journalctl -u wedalet --since today

# 查看最近 1 小时的日志
journalctl -u wedalet --since "1 hour ago"

2.2 服务控制

# 重启安装器服务
systemctl restart wedalet

# 查看服务运行状态
systemctl status wedalet

# 停止安装器服务
systemctl stop wedalet

# 启动安装器服务
systemctl start wedalet

# 重新加载服务配置
systemctl reload wedalet

2.3 开机自启管理

# 启用开机自启动
systemctl enable wedalet

# 禁用开机自启动
systemctl disable wedalet

# 查看自启动状态
systemctl is-enabled wedalet

3. 故障排除命令

3.1 系统状态检查

# 检查 Docker 服务状态
systemctl status docker

# 检查容器运行状态
docker ps -a

# 检查系统资源使用情况
df -h
free -h

3.2 网络连接检查

# 检查端口占用情况
netstat -tlnp | grep :8080

# 检查防火墙状态
systemctl status firewalld

4. 最佳实践

4.1 操作前准备

  • 权限检查:确保具有 root 或 sudo 权限
  • 数据备份:重要操作前备份关键数据和配置
  • 版本确认:确认当前平台版本,选择正确的命令

4.2 故障排除流程

  1. 查看服务状态:使用 systemctl status 检查服务状态
  2. 检查日志信息:使用 journalctl 查看详细错误信息
  3. 验证系统资源:检查磁盘空间、内存使用情况
  4. 网络连通性:确认端口和网络配置正确

4.3 安全注意事项

  • 定期备份重要数据和配置文件
  • 在生产环境中谨慎执行数据清理操作
  • 记录重要操作的执行时间和结果
  • 建议在维护窗口期间执行重启和升级操作