核心内容摘要
LeetCode 388 文件的最长绝对路径
Wiki.js 是一款轻量化且高度灵活的知识管理工具核心功能围绕文档的创建、分类与协作展开支持 Markdown 编辑、精细化权限管控还能通过插件拓展 PDF 导出、多系统同步等能力既适合企业团队统一管理项目文档、核心策略也适配个人整理学习笔记、生活攻略等场景对比传统文档工具它兼具 Word 的编辑实用性与 Notion 的轻量化优势上手门槛低且自定义空间大。
使用 Wiki.js 一段时间后发现这款工具虽好用但有几个需要注意的点比如初次配置权限时要根据团队角色精准划分避免普通成员误改核心文档Markdown 编辑虽便捷但复杂格式排版需提前熟悉语法否则容易出现格式错乱另外本地部署后数据仅存储在服务器建议定期备份防止意外丢失。
不过 Wiki.js 仅在局域网内使用时局限性十分明显比如居家办公想调取公司知识库的项目资料只能借助云盘传输敏感文档既不安全也耗时外出见客户时无法实时展示最新的产品文档只能提前下载好静态版本一旦文档更新就会出现信息滞后个人碎片化整理的笔记也只能在固定设备上查看通勤路上想补充内容都做不到。
而将 Wiki.js 与 cpolar 内网穿透结合后这些问题都能迎刃而解无需搭建复杂的私有云仅通过简单配置就能让内网的知识库突破物理边界既保留了 Wiki.js 本身的权限安全优势又能实现跨地域访问 —— 在家、出差甚至跨国办公时都能随时更新或查看文档小团队也能以极低的成本实现高效的知识共享。
本文将介绍如何用 Docker 容器技术部署 Wiki.js 应用程序并且结合cpolar发布至公网实现知识库共享。
Wiki.js 是一个高度可定制 Wiki 平台用 Node.js 编写支持 Markdown 以及 HTML 文档。
Docker 容器技术可帮助我们简化部署过程提高应用程序的可移植性和可扩展性。
安装Docker本文演示环境CentOS 7 使用Xshell7进行SSH操作如没有安装Docker需先安装Dockercurl-fsSL https://get.docker.com|bash-sdocker本篇文章使用Docker Compose实现Wiki.js的一键部署输入下方命令显示版本号即为安装成功。
dockercompose version
获取Wiki.js镜像Docker 中镜像是一个只读模板可创建 Docker 容器Wiki.js 官方提供了预构建 Docker 镜像我们可直接从 Docker Hub 中拉取。
首先创建一个 dockers-compose.yml文件mkdircompose进入目录中cdcompose/编写 docker-compose.yml 文件内容复制以下内容注意容器的用户名密码和数据库的要一致version:3services: db: image: postgres:15-alpine environment: POSTGRES_DB: wiki POSTGRES_PASSWORD: wikijsrocks POSTGRES_USER: wikijs logging: driver:nonerestart: unless-stopped volumes: - db-data:/var/lib/postgresql/data wiki: image: linuxserver/wikijs depends_on: - db environment: DB_TYPE: postgres DB_HOST: db DB_PORT:5432DB_USER: wikijs DB_PASS: wikijsrocks DB_NAME: wiki restart: unless-stopped ports: -3000:3000volumes: db-data:保存配置文件后执行下面的命令即可部署 Wiki.jsdockercompose up -d
本地服务器打开Wiki.js并添加知识库内容打开一个新的浏览器输入本机IP:3000进行初始配置输入管理员的邮箱、密码访问地址设置是否匿名反馈使用情况创建完成后跳转到登录页面输入刚才创建的管理员账号密码登录出现下方界面点击ADMINISTRATION进入后台进入后台界面后点击Local选择语言下载语言包选择Chinese Simplified最后点击右上角APPLY切换至首页创建主页内容。
这里可以选择使用何种编辑器来创建这里我们以 Markdown 为例接下来我们创作
文章先设置页面属性重点设置标题、路径填写完成后点击右上角的OK填写好内容后点击右上方的创建返回到主页可以看到刚创建的文章内容这样我们就在本地使用Docker搭建了一个wiki的知识库系统但是目前仅限于本地的访问如果我们想把创作好的文章内容发给身边的朋友查看或者需要进行异地访问创作等接下来我们就可以结合cpolar内网穿透将搭建好的知识库发布至公网进行远程访问。
实现公网访问Wiki.js上面在本地Docker中成功部署了Wiki.js并局域网访问成功,下面我们在Linux安装Cpolar内网穿透工具,通过Cpolar 转发本地端口映射的http公网地址,我们可以很容易实现远程访问,而无需自己注册域名购买云服务器.下面是安装cpolar步骤cpolar官网地址: https://www.cpolar.com使用一键脚本安装命令curl-L https://www.cpolar.com/static/downloads/install-release-cpolar.sh|sudobash向系统添加服务sudosystemctlenablecpolar启动cpolar服务sudosystemctl start cpolarcpolar安装成功后在外部浏览器上访问Linux 的9200端口 即:【http://局域网ip:9200】使用cpolar账号登录(如没有账号,可以点击下面免费注册),登录后即可看到cpolar web 配置界面,接下来在web 管理界面配置即可接下来配置一下Wiki.js的公网地址登录后点击左侧仪表盘的隧道管理——创建隧道创建一个Wiki.js的公网http地址隧道!隧道名称可自定义命名注意不要与已有的隧道名称重复协议选择http本地地址3000 (本地访问的地址)域名类型免费选择随机域名地区选择China Top点击创建隧道创建成功后点击左侧的状态——在线隧道列表,查看所生成的公网访问地址有两种访问方式,一种是http 和https使用上面的Cpolar https公网地址,在任意设备的浏览器进行访问,即可成功看到Wiki.js界面,这样一个公网地址且可以远程访问就创建好了,使用了cpolar的公网域名,无需自己购买云服务器,即可发布到公网进行远程访问小结如果我们需要把创作的WIki知识库长期发布至公网分享给别人查看由于刚才创建的是随机的地址24小时会发生变化。
另外它的网址是由随机字符生成不容易记忆。
如果想把域名变成固定的二级子域名并且不想每次都重新创建隧道可以选择创建一个固定的http地址来解决这个问题。
固定Wiki.js公网地址我们接下来为其配置固定的HTTP端口地址该地址不会变化方便分享给别人长期查看你的博客而无需每天重复修改服务器地址。
配置固定http端口地址需要将cpolar升级到专业版套餐或以上。
登录cpolar官网点击左侧的预留选择保留二级子域名设置一个二级子域名名称点击保留,保留成功后复制保留的二级子域名名称保留成功后复制保留成功的二级子域名的名称修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名点击更新(注意,点击一次更新即可,不需要重复提交)更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名最后,我们使用固定的公网https地址访问,可以看到访问成功这样一个固定且永久不变的公网地址就设置好了,成功实现了在异地我们也可以进行远程创作并且随时随地都可以把Wiki知识库分享给其他人了Wiki.js 本身已是实用的知识管理工具结合 cpolar 内网穿透后进一步打破了局域网的限制让知识管理真正实现 “随时随地”。
无论是团队协作还是个人使用都能在保障安全的前提下提升文档访问与更新的灵活性适配更多元的使用场景。
cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站