引言
- 背景:开发运维需要大量常用命令和工具,频繁切换在线工具不便
- 核心价值:一站式 Linux 命令查询平台,支持私有化部署
- 适用场景:内部知识库、开发团队工具集、运维文档中心
前置条件
- 系统要求
- Docker 引擎 19.03+
- 网络连接正常
- 端口 3000/9665 可用
- 工具准备
- Docker 和 Docker Compose
- 浏览器
快速部署
1️⃣ 单容器部署
docker run --name linux-command \ --rm -d \ -p 9665:3000 \ wcjiang/linux-command:latest访问地址:
- 内网:
http://<服务器 IP>:9665 - 外网:
http://linux-command.start6.cn
2️⃣ Docker Compose 部署(推荐)
创建docker-compose.yml:
version:'3.8'services:linux-command:image:wcjiang/linux-command:latestcontainer_name:linux-commandports:-"9665:3000"restart:unless-stoppedenvironment:-TZ=Asia/Shanghai-PUID=1000-PGID=1000volumes:-./config:/app/confignetworks:-app-networknetworks:app-network:driver:bridge执行部署:
docker-compose up -d3️⃣ systemd 服务管理
创建/etc/systemd/system/linux-command.service:
[Unit] Description=Linux Command Tool After=network.target docker.service Wants=docker.service [Service] Type=simple User=www-data ExecStart=/usr/bin/docker run --rm --name linux-command \ -p 9665:3000 \ wcjiang/linux-command:latest Restart=always RestartSec=5s [Install] WantedBy=multi-user.target启动服务:
sudo systemctl start linux-command sudo systemctl enable linux-command sudo systemctl status linux-command功能特性
4️⃣ 核心功能
| 功能模块 | 描述 |
|---|---|
| 🔍 命令查询 | 支持模糊搜索常用 Linux 命令 |
| 📖 命令详解 | 包含语法、参数说明、使用示例 |
| 🌐 在线示例 | 交互式在线执行命令示例 |
| 📊 命令统计 | 高频命令排行榜 |
| 🖨️ 文档导出 | 支持导出命令文档 |
5️⃣ 常用命令分类
- 系统管理:
system,process,network,disk - 文件操作:
file,tar,zip,rm,cp,mv - 文本处理:
grep,awk,sed,sort,uniq - 网络工具:
curl,wget,ssh,telnet - 开发工具:
git,docker,kubectl,npm
配置优化
6️⃣ 自定义配置
进入容器配置目录:
# 查看配置目录 docker exec -it linux-command bash cd /app/config # 编辑配置文件 vim app.config.json示例配置:
{ "title": "Linux 命令查询工具", "description": "一站式 Linux 命令查询平台", "theme": { "primaryColor": "#2196F3", "secondaryColor": "#FF9800" }, "features": { "search": true, "examples": true, "export": true } }重启容器:
docker-compose restart linux-command7️⃣ 多实例部署
如需部署多个实例(不同端口):
# 实例 1 docker run --name linux-command-1 \ -p 9665:3000 \ wcjiang/linux-command:latest # 实例 2 docker run --name linux-command-2 \ -p 9666:3000 \ wcjiang/linux-command:latest数据持久化
8️⃣ 配置持久化
# 挂载配置目录 -v ./config:/app/config # 备份配置 docker exec linux-command tar -czvf config-backup.tar.gz /app/config9️⃣ 数据卷管理
# 查看挂载卷 docker volume ls # 删除并重建 docker-compose down docker-compose up -d性能优化
🔟 资源限制
修改docker-compose.yml:
services:linux-command:deploy:resources:limits:cpus:'0.5'memory:512Mreservations:cpus:'0.25'memory:256M1️⃣1️⃣ 缓存优化
# 更新镜像缓存 docker pull wcjiang/linux-command:latest # 清理未使用的镜像 docker image prune -f常见问题
Q1: 容器启动失败怎么办?
A: 检查以下几点:
- 端口是否被占用:
sudo lsof -i :9665 - Docker 服务是否运行:
sudo systemctl status docker - 查看容器日志:
docker logs linux-command
Q2: 访问页面空白或报错?
A: 执行以下诊断:
# 检查容器状态 docker inspect linux-command # 查看日志 docker logs --tail 50 linux-command # 进入容器调试 docker exec -it linux-command bashQ3: 如何更新到最新版本?
A:
# 拉取最新镜像 docker pull wcjiang/linux-command:latest # 重启容器 docker-compose restart linux-command # 或使用 systemd sudo systemctl restart linux-commandQ4: 如何备份和恢复数据?
A:
# 备份配置 tar -czvf linux-command-backup.tar.gz ./config # 恢复配置 tar -xzf linux-command-backup.tar.gz -C /path/to/config docker-compose restart linux-command监控与维护
1️⃣2️⃣ 健康检查
# 检查容器状态 docker ps | grep linux-command # 查看资源使用 docker stats linux-command # 检查日志 journalctl -u linux-command -f1️⃣3️⃣ 定期维护
# 清理临时文件 docker system prune -f # 更新依赖 docker-compose pull docker-compose up -d # 查看容器健康状态 docker inspect --format='{{.State.Health.Status}}' linux-command推荐资源
- 官方 GitHub:https://github.com/jaywcjlove/linux-command
- 项目文档:https://linux-command.github.io/
- Docker Hub:https://hub.docker.com/r/wcjiang/linux-command
如果你觉得这个回答对你有帮助,欢迎关注我【一行梦境】,我会在那里分享更多深度内容和实用技巧。