从大三决然的跳入前端大坑，到如今已是毕业两年的杭州社畜。脑子依旧清晰地记得，我选择前端时的孤独，周围都是清一色的后端方向，图书馆里我与灯为伴，以书为友。三年光阴不长不短，每学一样，就会鹦鹉学舌地实践，但似乎在别人眼里我一直在变着花样开发烂大街的网址导航。今天它 star 终于破百，我超级开心，毛遂自荐一下！
📌 关于
码云仓库地址：/HuaSenJioJio/huasenjio-compose
Github 仓库地址：/huasenjio/huasenjio-compose
花森系列网站增添新作品，（huasenjio-compose）官方仓库，基于 vue.js、node.js、docker-compose、redis、mongodb、jenkins 组合构建的容器应用。如果我的项目给您带来帮助，请点一个 star（🌟）！您的鼓励和支持，对我真的很重要！
💪 开源列表
✅ 花森门户容器版（huasenjio-compose）
✅ 花森门户静态版（huasen-protal）
✅ 花森脚手架（huasen-cli）
☑️ 花森低代码平台 （预研）
☑️ 花森流程引擎（预研）
🤩 在线体验
由于服务器配置过于垃圾，首次访问较慢，请耐心等待，如果加载卡死，则重新刷新网页。不是代码写得烂，相反我已进行性能优化，并且经过实践验证，服务器配置较好的情况下，访问速度很快！
1.网址导航
2.博客
3.个人引导页
💡 平台简介
花森门户由浏览器主页网址导航、博客系统、后台管理系统组成，浏览器主页收录资源网站，涵盖了日常生活、娱乐、学习、影视、考研、工作、科技、实用工具等领域。博客系统，定期分享实用教程、计算机知识、资源软件等文章，致力于提供高效上网冲浪环境的公益性平台！
📙 功能清单
官网
✅ 界面响应式适配，不同设备完美呈现；
✅ 数据离线存储，无需登录，畅享所有，支持数据拷贝恢复；
✅ 云端备份，多设备数据同步；
✅ 自定义网站收录，收藏精品站点；
✅ 鼠标右键改色，创建专属皮肤；
✅ 更换皮肤壁纸；
✅ 多引擎搜索框，支持百度热词提示；
✅ 站内链接搜索，支持从名称、描述、备注搜索站点，一键直达网站；
✅ 邮箱登录注册；
✅ 极简模式，干净简洁；
✅ 订阅切换；
✅ 实时天气；
✅ Markdown 文章阅读，支持三级锚点目录；
☑️ ChatGPT；
☑️ 提交链接；
✅ 动态修改品牌名、logo、404重定向地址；
☑️ …
后台管理
✅ 实时访客统计，记录 PV、UV、IP、反向链接、设备，精准掌控流量（不涉及敏感信息）；
✅ 服务器状态监听，记录 CPU、内存、磁盘使用占比；
✅ Markdown 文章发布；
✅ 订阅源管理，一键管理订阅源、栏目、网链；
✅ 账户管理，包括用户、管理员、黑名单信息管理；
✅ 图标制作，支持文字、上传、爬取三种方式生成图标；
✅ 日志管理；
✅ 配置管理，支持配置壁纸、网站等信息；
✅ 动态脚本执行面板；
✅ 文件管理，支持图片、视频、PDF、文档等文件存储；
✅ 新增图标库选择功能；
☑️ PDF 在线阅读；
✅ 完善批量删除；
☑️ 提交链接审核；
☑️ …
后台服务
✅ 自研的并发处理器，轻松抗下 1000 并发；
✅ 多容器一键部署，经典的 MVC 架构；
✅ 黑名单拦截；
✅ 权限管理，支持 jwt 身份校验；
✅ 数据加密传输，支持对称、非对称加密传输；
✅ 邮件发送；
✅ 日志系统；
✅ 定时任务；
✅ Websocket 实时通讯；
✅ 多线程处理；
✅ 文件上传；
✅ 跨域处理；
☑️ 资源防盗链；
☑️ SEO 优化；
☑️ …
✨ 界面功能预览
快照更新于 年 4 月 28 日
1.响应式适配
2.首页+搜索+右键换肤
3.极简模式
4.自定义收录
5.皮肤主题
6.文章展示
7.文章阅读
8.数据仪表盘
9.文章发布
10.栏目管理
11.网链管理
12.文章管理
🧩 技术架构
前端基于 Vue.js（2.6.x）、ElementUI、Tailwindcss、Axios 等技术开发的 Web 应用，服务端基于 Node.js、Mongodb、Redis、Express 开发的服务框架，使用 Nginx 作为代理服务器转发请求，选择 jenkins 实现 CI/CD，借助 docker 进行一键容器化部署。
🔨 快速部署
/07/28 部署方式：
1.常规部署
2.宝塔部署
3.一键脚本部署（推荐）
方式1：常规部署
⚠️ 打开弹幕和查看评论区
视频教程：/video/BV1G44y1Q7MV
🏁 测试环境
Centos 7.4；腾讯云服务器 1 核 2G（学生机）；🏁 安装依赖
一.Git
安装 git 版本管理工具，直接拉取源码到服务器，免去通过 xfpt 上传源码文件的繁琐过程。
（1）安装 wandisco 仓库包
yum install /centos/7/git/x86_64/wandisco-git-release-7-2.noarch.rpm
（2）安装 git 安装包
yum -y install git
（3）验证版本
git version
二.Docker
（1）卸载旧版本
yum remove -y docker \docker-client \docker-client-latest \docker-common \docker-latest \docker-latest-logrotate \docker-logrotate \docker-selinux \docker-engine-selinux \docker-engine
（2）安装依赖工具包
yum install -y yum-utils \device-mapper-persistent-data \lvm2
（3）设置 yum 源
sudo yum-config-manager --add-repo /docker-ce/linux/centos/docker-ce.reposudo yum makecache fast
（4）安装 docker
yum install -y docker-ce
（5）启动 docker
systemctl start docker.service
（6）设置开机自启动
systemctl enable docker.service
（7）设置权限
sudo chmod a+rw /var/run/docker.sock
（8）查看版本
命令行执行docker version如下命令，输出有 Client 和 Server 服务，则说明运行正常。
（9）安装 vim 工具
如果系统没有自带 vim 编辑器，则使用如下命令进行安装。
yum -y install vim*
（10）添加镜像源配置文件
默认通过官方镜像源拉取，速度特别慢，并且容易卡死，所以需要替换镜像源，如果目录下不存在 daemon.json 配置文件，则新建配置文件，执行vim /etc/docker/daemon.json命令，输入配置如下：
{"registry-mirrors": ["https://registry.docker-","http://hub-mirror.","https://docker.mirrors."],"ipv6":false}
（11）重载配置
⚠️ 不然配置不会生效
执行sudo systemctl daemon-reload命令
（12）重启 docker
⚠️ 不然配置不会生效
执行sudo systemctl restart docker命令
三.Docker-compose
安装 docker-compose 服务，负责对 docker 容器进行集群和快速编排。
（1）下载资源
sudo curl -L "/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
（2）设置权限
sudo chmod +x /usr/local/bin/docker-compose
（3）建立软连接
不建立软连接，可能无法使用 docker-compose 命令。
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
（4）查看版本
docker-compose --version
🏁 运行容器
通过上一步，我们已经安装好 git、docker、docker-compose 服务，接下来我们拉取源码，直接运行容器。
（1）通过 git 拉取源码
git clone /huasenjio/huasenjio-compose.git
（2）进入 huasenjio-compose 目录
cd huasenjio-compose
（3）运行容器
执行运行容器命令后，docker 将自动拉取安装配置 nginx、mongodb、redis、jenkins、后端服务，第一次会比较缓慢，请耐心等待，如果遇到卡死的情况，使用ctrl + c终止命令，然后重复执行运行容器命令即可。
docker-compose up -d
（4）访问站点
容器启动成功之后，我们在浏览器地址栏输入如下地址：
官网：协议://ip/portal/后台管理：协议://ip/admin/默认管理员：admin@/12345
方式2：宝塔部署
⚠️ 打开弹幕和查看评论区
视频教程：/video/BV1xA411z7QA
🏁 测试环境
Centos 7.4；腾讯云服务器 1 核 2G（学生机）；宝塔面板正式版；🏁 流程
进入宝塔面板，安装 docker，拉取 git 源码，修改 docker-compose.yml 文件，添加 compose 模版，添加运行项目。如果宝塔面板已安装 nginx，需要修改 docker-compose.yml配置文件的 nginx 的运行端口，否则端口冲突，无法启动容器。
方式3：一键脚本部署
⚠️ 视频教程待发布
🏁 测试环境
Centos 7.4；腾讯云服务器 1 核 2G（学生机）；🏁 流程
把huasenjio-compose/bin/install.sh脚本，传输到服务器，使用chmod u+x huasen-compose/bin/*设置权限之后，执行install.sh脚本，自动安装部署。更多操作脚本，请查阅huasenjio-compose/bin/readme.md文档。
❓ 常见 QA
（1）按照步骤操作，导航、博客、后台管理网站可以直接访问？
是的，项目采取容器化配置，只要一次安装运行成功，即可访问使用，无需其他繁琐配置。
（2）为什么容器运行失败？
运行容器时，请确保 80、37017、7379、8080、3000、8181 端口不被占用，可以通过netstat -anp | grep 端口号检查端口占用情况，如果不幸已经有服务占用端口，则需要修改docker-compose.yml中对应容器的端口后，重新执行运行容器命令。
（3）运行成功，但是还是无法访问到站点？
如果服务已经正常启动，但是无法访问站点，需要检查一下服务器防火墙和安全组配置，是否限制 80 端口的访问，可以使用端口检测工具，进行检测。
（4）用户注册时，为什么邮箱验证码无法发送？
由于邮箱验证码功能依赖 nodemailer 库实现，需要部署之前修改/huasenjio-compose/huasen-server/config.js中的QQ_MAIL配置项，更改成自己的申请邮箱地址和 mtp 通行码。
（5）mongodb 数据库的存储位置？
工程根目录下huasen-mongo/volume文件夹，就是数据库的数据文件夹。
（6）如何删除容器，重新启动容器？
进入 huasenjio-compose 目录，打开终端，通过docker-compose down，停止容器，删除容器。
（7）如何重新构建镜像？
进入 huasenjio-compose 目录，打开终端，通过docker-compose build --no-cache，不使用缓存，重新构建镜像。
（8）如何操作服务器防火墙？
开启防火墙：systemctl start firewalld关闭防火墙：systemctl stop firewalld查看防火墙：systemctl status firewalld查看指定端口：firewall-cmd --query-port=8080/tcp打开指定端口：firewall-cmd --add-port=8080/tcp --permanent重载端口数据：firewall-cmd --reload关闭指定端口：firewall-cmd --permanent --remove-port=8080/tcp
（9）如何配置放开安全组？
因为服务器提供商的应用界面不同，所以省略教程，大家平时使用阿里云、腾讯云、华为云等服务器提供商的服务器，都是可以轻易地百度到安全组的操作教程！
（10）如何升级网站？
（10-1）使用脚本
进入项目根目录，使用 chmod u+x ./bin/* 为脚本设置可执行权限，然后执行 ./bin/upgrade.sh，耐心等待，拉取新代码，升级网站。
（10-2）使用 jenkins
⚠️《📽 视频教程》章节列有视频教程
网站采用 docker-compose 编排容器，一键部署网站的同时，也在 8080 端口安装 jenkins 用于实现 CI/CD ，另外注意 jenkins 会占用大概 20%的内存，如果不使用可以关闭，进入项目根目录，执行 docker-compose stop jenkins，完成停止 jenkins 容器。
（11）如何修改前端界面？
⚠️ 需要 node.js 环境
进入官网的源码路径 /huasenjio-compose/huasen-frontend/portal 的终端，执行 npm install，安装依赖，然后执行 npm run server 启动项目进行开发，改动代码之后，使用 npm run build 打包代码，构建后的代码输出在 /huasenjio-compose/huasen-server/public/webapp/portal 下，需要拷贝到服务器的对应位置，最后执行 /huasenjio-compose/bin/update.sh 脚本更新网站。
（12）如何修改后台管理界面？
⚠️ 需要 node.js 环境
进入后台管理的源码路径 /huasenjio-compose/huasen-frontend/admin 的终端，执行 npm install，安装依赖，然后执行 npm run server 启动项目进行开发，改动代码之后，使用 npm run build 打包代码，构建后的代码输出在 /huasenjio-compose/huasen-server/public/webapp/admin 下，需要拷贝到服务器的对应位置，最后执行 /huasenjio-compose/bin/update.sh 脚本更新网站。
（13）如何修改后端服务？
⚠️ 需要 node.js 环境
进入项目根目录 /huasen-compose 项目执行 docker-compose up -d redis mongo 提前开启本地 redis、mongo 服务，然后进入后端服务代码路径 /huasen-compose/huasen-server，执行 npm install，安装依赖，通过 npm run dev 启动后端服务开发，最后拷贝整个/huasen-compose/server 到服务器的对应位置，执行 /huasen-compose/bin/update.sh 脚本更新网站。
（14）如何修改 nginx 的运行端口？
进入项目根目录，打开docker-compose.yml，修改 published 属性，端口号建议选 3000-10000 范围，然后执行 /huasen-compose/bin/update.sh 脚本更新网站。
📽 视频教程
（1）通过 docker-compose 安装教程
/video/BV1G44y1Q7MV
（2）通过宝塔面板安装教程
/video/BV1xA411z7QA
（3）自动化部署教程
⚠️ 视频中的示例脚本已过时，以文档内提供的 shell 脚本为准！
/video/BV1vg4y1E7xy
（3-1）构建完成后执行的 shell 脚本
⚠️ 注意确保路径正确
# 设置权限chmod u+x ./bin/*# 执行脚本./bin/upgrade-jenkins-init.sh
（3-2）远程执行的 shell 脚本
⚠️ 注意确保路径正确
# 设置权限chmod u+x /root/huasen-compose/huasen-jenkins-cache/bin/*# 执行脚本/root/huasen-compose/huasen-jenkins-cache/bin/upgrade-jenkins.sh
🐛 开发者指南
⚠️ 以下内容适合有编程基础的小伙伴观看
目录结构
├── bin// 快捷操作脚本├── huasen-mongo // mongodb 数据库配置和数据├── huasen-nginx // nginx 配置├── huasen-redis // redis 配置和数据└── huasen-server// 后端服务├── app.js// 服务入口文件├── setting.json// 网站配置文件└── config.js // 服务配置文件├── huasen-store // 静态文件仓库├── huasen-jenkins// jenkins 配置├── docker-compose.yml // docker-compose 配置文件└── huasen-frontend // 界面源码├── admin // 后台管理界面源码├── portal // 前台站点源码└── guide // 个人引导页源码
本地启动调试
一.官网
⚠️ 进入/huasenjio-compose/huasen-frontend/portal 目录下执行命令
（1）安装依赖
npm install
（2）运行程序
npm run serve
（3）打包构建
npm run build
二.后台管理
⚠️ 进入/huasenjio-compose/huasen-frontend/admin 目录下执行命令
（1）安装依赖
npm install
（2）运行程序
npm run serve
（3）打包构建
npm run build
三.后台服务
⚠️ 进入/huasenjio-compose/huasen-server 目录下执行命令
（1）安装依赖
npm install
（2）运行程序
进入项目根目录执行 docker-compose up -d redis mongo 提前开启本地 redis、mongo 服务
npm run dev
❌ 声明
仅供学习参考，未经授权，禁止商业使用！
🥳 联系我们
由于涉及知识面较广，无法使用文字全面讲解，可以关注我的 Bilibili 账号，后续更新视频教程，感兴趣的小伙伴可以添加站长微信 ，进入前端技术交流群！
🐧 企鹅 QQ：184820911
😸 微信 ：huasencc（站长邀请进入前端交流群）
📮 邮箱 ：184820911@
📺 bilibili：花森酱
如果觉得《强势开源 Star 破百 仅一行代码 拥有网址导航 + 博客 + 后台管理网站。》对你有帮助，请点赞、收藏，并留下你的观点哦！
