ShowDoc自动化安装与部署指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00181/article/details/148392806

ShowDoc自动化安装与部署指南

showdoc ShowDoc is a tool greatly applicable for an IT team to share documents online一个非常适合IT团队的在线API文档、技术文档工具项目地址: https://gitcode.com/gh_mirrors/sh/showdoc

前言

ShowDoc是一款优秀的文档管理系统，广泛应用于团队协作和知识管理。本文将详细介绍如何使用自动化脚本在Linux服务器上快速部署ShowDoc环境，适合希望快速搭建文档系统的用户。

自动化安装原理

自动化安装脚本基于Docker容器技术实现，主要包含以下核心功能：

Docker环境检测：脚本会自动检查服务器是否已安装Docker，若未安装则会自动安装
容器化部署：使用Docker容器运行ShowDoc，隔离应用环境
数据持久化：所有文档数据会保存在宿主机指定目录，确保数据安全

系统要求

Linux操作系统（推荐CentOS 7+/Ubuntu 16.04+）
1GB以上内存
2GB以上磁盘空间
网络连接正常

安装步骤

基础安装

执行以下命令进行标准安装（中文版）：

curl -fL https://www.showdoc.cc/script/showdoc | bash

如需安装英文版，添加en参数：

curl -fL https://www.showdoc.cc/script/showdoc | bash -s en

安装过程说明

Docker检测与安装：脚本会先检查Docker是否已安装，若未安装则自动安装
镜像拉取：从官方仓库拉取ShowDoc最新镜像
容器创建：创建并启动ShowDoc容器
数据目录初始化：在/showdoc_data/html目录下初始化数据

安装后配置

访问系统

安装完成后，通过以下地址访问ShowDoc：

http://服务器IP或域名:4999

默认管理员账号

用户名：showdoc
密码：123456

安全提示：首次登录后请立即修改默认密码。

数据存储位置

所有ShowDoc数据存储在以下目录：

/showdoc_data/html - 包含文档数据、上传文件等

高级管理命令

服务管理

# 停止ShowDoc服务
curl -fL https://www.showdoc.cc/script/showdoc | bash -s stop

# 重启ShowDoc服务
curl -fL https://www.showdoc.cc/script/showdoc | bash -s restart

系统维护

# 更新到最新版本
curl -fL https://www.showdoc.cc/script/showdoc | bash -s update

# 卸载ShowDoc
curl -fL https://www.showdoc.cc/script/showdoc | bash -s uninstall

从手动安装迁移到自动脚本

如果之前是手动安装的ShowDoc，可以按照以下步骤迁移到自动脚本管理：

先按照标准流程安装自动脚本版ShowDoc
迁移数据文件：
- 将原Sqlite/showdoc.db.php覆盖到/showdoc_data/html/Sqlite/showdoc.db.php
- 将原Public/Uploads覆盖到/showdoc_data/html/Public/Uploads
执行权限设置和更新命令：

chmod 777 -R /showdoc_data/html
curl -fL https://www.showdoc.cc/script/showdoc | bash -s update

常见问题处理

Docker安装失败：建议先手动安装Docker后再执行脚本
端口冲突：确保4999端口未被占用，或修改脚本使用其他端口
权限问题：确保/showdoc_data目录有足够权限

总结

通过自动化脚本安装ShowDoc是最快捷的部署方式，特别适合需要快速搭建文档系统的场景。脚本提供了完整的生命周期管理功能，包括安装、更新、重启和卸载等，大大简化了运维工作。对于生产环境，建议在安装完成后及时修改默认密码并做好数据备份。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考