正文

JEECMS模板建站实操，从零到上线的新手完整教程

小海不是菜
小海不是菜 V管理员 /1.05 K阅读/3评论
0914
文章最后更新时间2026年09月14日，若文章内容或图片失效，请留言反馈！

适用人群说明

这篇文章适合想用 JEECMS模板 快速搭建企业官网、学校门户、政府信息站、SEO内容站的新手，你不需要精通Java，也不需要会写复杂后端代码，只要会基本的服务器操作、MySQL建库、FTP或宝塔面板上传文件，就能跟着步骤把网站搭起来，尤其适合Java初学者、前端转CMS、运维兼职站长、中小企业网络负责人，前提是：你愿意按顺序操作,不跳过配置和缓存清理。

完整搭建步骤

准备环境

推荐Linux服务器：CentOS 7/8、Ubuntu 20.04以上，安装JDK 8或11、Tomcat 8/9、MySQL 5.7/8.0、Nginx可选，Windows本地也可先用Tomcat+MySQL跑通,装完后确认：

java -version
mysql -uroot -p

Tomcat能访问默认页，MySQL能登录,说明基础环境没问题。

创建数据库并导入数据

登录MySQL,创建库：

JEECMS模板建站实操，从零到上线的新手完整教程

JEECMS模板建站实操，从零到上线的新手完整教程

CREATE DATABASE jeecms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

然后导入JEECMS安装包里的SQL文件，导入时注意字符集，别用latin1,否则中文会乱码。

修改数据库连接配置

解压JEECMS安装包或源码，找到配置文件，通常在WEB-INF/classes下，可能是application.properties、db.properties或类似文件，修改数据库地址、库名、用户名、密码：

jdbc.url=jdbc:mysql://127.0.0.1:3306/jeecms?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
jdbc.username=root
jdbc.password=你的密码

不同版本文件名不一样，以实际包为准,改完保存。

部署到Tomcat

把war包放进tomcat/webapps，可以改名成ROOT.war，这样访问域名时不用带项目名；也可以保留jeecms.war，访问路径就是/jeecms,启动Tomcat：

cd /usr/local/tomcat/bin
./startup.sh
tail -f ../logs/catalina.out

看到启动成功、无报错,再访问：

http://服务器IP:8080/jeecms/

如果部署为ROOT，就访问http://服务器IP:8080/。

进入后台初始化

按安装向导或官方默认入口进入后台，首次登录后立刻改管理员密码，然后进入“站点管理”，新增站点：填写站点名称、域名、模板方案、静态页目录、资源路径，站点ID记下来,后面模板目录要用。

安装JEECMS模板

JEECMS模板不是普通HTML，里面包含Freemarker标签,安装方式有两种：

  • 后台“模板管理”里导入模板zip包；
  • 通过FTP或宝塔上传到模板目录,常见路径是：
/WEB-INF/template/{站点ID}/{模板方案}/

模板目录里一般要有：index.html、channel.html、content.html、header.html、footer.html、css/、js/、images/，上传后回到后台,选择对应模板方案。

绑定栏目和内容模板

进入“栏目管理”，逐个编辑栏目,重点设置：

  • 栏目页模板：选channel.html；页模板：选content.html；
  • 首页模板：在站点设置或模板方案里指定index.html；
  • 静态化规则：按需开启。

然后新建栏目，发布几篇测试文章，上传缩略图，设置推荐位，前台能显示,说明模板绑定成功。

生成静态页并配置域名

先在后台“更新缓存”，再执行“生成首页”“生成栏目”“生成内容”，如果开启静态化,Nginx的root要指向静态页目录，

server {
    listen 80;
    server_name www.example.com;
    root /usr/local/tomcat/webapps/ROOT/html/1;
    index index.html;
    location / {
        try_files $uri $uri/ @tomcat;
    }
    location @tomcat {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }
}

解析域名到服务器IP，重启Nginx，用域名访问,需要HTTPS就再加SSL证书。

JEECMS模板配置要点

  1. 模板路径必须对：/WEB-INF/template/{站点ID}/{模板方案}/,少一层都可能导致后台找不到模板。
  2. 标签要成对闭合,常用标签如：
[@cms_channel_list parentId='1' count='10']
  <#list tag_list as c>
    <a href="${c.url}">${c.name}</a>
  </#list>
[/@cms_channel_list]
[@cms_content_list channelId='10' count='8' orderBy='2']
  <#list tag_list as a>
    <a href="${a.url}">${a.title}</a>
  </#list>
[/@cms_content_list]
  1. 资源路径别写死localhost,统一用站点资源变量或相对路径。
  2. 编码统一UTF-8：数据库utf8mb4，模板文件UTF-8无BOM，Tomcat URIEncoding设为UTF-8。
  3. 改模板后必须清缓存、重启Tomcat、浏览器强刷。
  4. 生产环境改模板前先备份,模板目录权限要给足但别755全开。

常见踩坑提醒

  • 模板放错目录：放在template根目录，后台选不到,必须放到站点ID和方案目录下。
  • 栏目没绑模板：列表页空白或404,检查栏目模板和内容模板。
  • 标签报错：Freemarker标签未闭合、参数写错、栏目ID不存在,前台直接500。
  • 修改不生效：缓存没清,或静态页没重新生成。
  • 图片CSS 404：路径写死、Nginx root配错、静态资源没同步。
  • 数据库报错：版本不兼容、密码错、时区错、字符集不是utf8mb4。
  • 访问404：部署路径是/jeecms却访问根目录,或者war名和访问路径不一致。
  • 静态化后内容旧：发布文章后要重新生成对应栏目和内容页。
  • 安全漏洞：默认后台没改、安装目录没删、数据库端口暴露，上线前改后台路径、强密码、限制IP、定期备份。

按这个流程走：先本地跑通，再上服务器；先动态调通，再开静态化；先备份，再改JEECMS模板，新手最容易卡住的就是路径、绑定、缓存三件事，把这三件事盯住,网站基本就能顺利搭起来。