站点根网址
“站点根网址”指的是你的网站在互联网上的完整根地址,它以 http:// 或 https:// 开头,并以 例如:https://www.yourdomain.com/。

DedeCMS 非常依赖这个设置来生成正确的链接。
如何在后台设置站点根网址
这是最重要的一步,请务必确保这里设置正确。
-
登录你的 DedeCMS 后台管理系统。
-
在左侧菜单栏中,找到并点击 【系统】 -> 【系统基本参数】。
(图片来源网络,侵删) -
在打开的页面中,找到 【站点信息】 这一栏。
-
你会看到以下几个关键选项:
-
站点根网址 (cfg_basehost)
- 作用:这是最核心的设置,用于生成网站的全局链接,如文章链接、图片链接、CSS/JS文件路径等。
- 如何填写:填写你的网站完整域名,必须以斜杠 结尾。
- 正确示例:
http://www.yourdomain.com/https://www.yourdomain.com/
- 错误示例:
http://www.yourdomain.com(缺少结尾的 )yourdomain.com(缺少协议http://或https://)
-
站点名称 (cfg_webname)
(图片来源网络,侵删)- 作用:显示在网站浏览器标签页上的标题,以及网站首页
<title>标签中。 - 如何填写:填写你的网站名称,如“我的博客”。
- 作用:显示在网站浏览器标签页上的标题,以及网站首页
-
主页链接 (cfg_indexurl)
- 作用:定义网站首页的链接地址,如果你的首页不是默认的
index.html,或者你想使用动态首页,就需要在这里修改。 - 默认值:
{dede:global.cfg_basehost/}/(它会自动调用上面的“站点根网址”) - 如何填写:通常保持默认即可,如果你想设置动态首页,可以改为
{dede:global.cfg_basehost/}/index.php。
- 作用:定义网站首页的链接地址,如果你的首页不是默认的
-
-
设置完成后,页面最下方有一个 【确定】 按钮,点击保存设置。
为什么站点根网址如此重要?
- 图片和附件路径:当你在文章中上传图片时,DedeCMS 会根据
cfg_basehost生成图片的完整地址,如果这里设置错误,网站上的所有图片都会显示不出来(显示为红色叉号)。 - 网站链接:网站内所有链接(如文章标题链接、栏目链接、分页链接等)的生成都依赖于这个根网址。
- SEO 优化:搜索引擎需要识别网站的正确域名,错误的设置可能导致 SEO 权分散(
http://yourdomain.com和http://www.yourdomain.com被视为两个不同的网站)。
网页主页链接
“网页主页链接”通常指的就是网站首页的 URL,在 DedeCMS 中,这个值主要由 cfg_basehost 和 cfg_indexurl 共同决定。
如何在后台设置主页链接
如上所述,你可以在 【系统基本参数】 -> 【站点信息】 中找到 【主页链接 (cfg_indexurl)】 进行设置。
-
静态首页 (推荐):
- 设置:保持默认值
{dede:global.cfg_basehost/}/ - 效果:网站首页地址为
https://www.yourdomain.com/index.html(前提是你开启了伪静态并生成了首页)。
- 设置:保持默认值
-
动态首页:
- 设置:修改为
{dede:global.cfg_basehost/}/index.php - 效果:网站首页地址为
https://www.yourdomain.com/index.php。
- 设置:修改为
如何在前台模板中调用主页链接
在制作网站模板(如 head.htm)时,你需要使用特定的代码来获取主页链接,而不是硬编码。
-
使用全局变量(推荐) 这是最标准、最灵活的方式,它会自动读取后台设置的
cfg_indexurl。<a href="{dede:global.cfg_indexurl/}">网站首页</a>或者
<a href="{dede:global.cfg_basehost/}/">网站首页</a>这两种写法在大多数情况下效果相同,但
{dede:global.cfg_indexurl/}更能体现“主页链接”的意图。 -
使用
arclist 如果你想在首页的某个位置调用“更多文章”并链接到首页,可以这样写:<a href="{dede:global.cfg_indexurl/}">查看更多文章</a> -
使用
typetype标签也可以用来获取首页链接。<a href="{dede:type}[field:typelink/]{/dede:type}">网站首页</a>在首页模板中,
{dede:type}标签默认指向的就是首页。
常见问题与排查
-
问题:网站图片显示不出来,是红叉。
- 原因:99% 的原因是 【站点根网址 (cfg_basehost)】 设置错误或未以
- 解决:请按照第一部分的方法,仔细检查并修正后台的站点根网址设置,然后保存。
-
问题:网站所有链接跳转后都变成
index.php。- 原因:通常是伪静态规则未配置正确,或者后台设置了动态首页,但服务器无法解析。
- 解决:
- 确保你的服务器(Apache/Nginx)已经安装并启用了 Rewrite 模块。
- 将 DedeCMS 根目录下的
httpd.ini(IIS) 或.htaccess(Apache) 文件上传到服务器根目录。 - 检查 【系统】 -> 【系统基本参数】 -> 【核心设置】 中的 是否使用伪静态 选项是否为“是”。
-
问题:更换了域名,但网站内容里的旧域名链接没有更新。
-
原因:只修改了后台的站点根网址,但数据库中已存在的内容(文章、图集等)里的链接还是旧的。
-
解决:你需要执行 SQL 语句来批量替换数据库中的旧域名。
- 进入 DedeCMS 后台的 【系统】 -> 【SQL命令行工具】。
- 在“运行 SQL 语句查询框”中输入以下命令(请将
olddomain.com和newdomain.com替换成你自己的域名):
-- 替换文章body中的旧域名 UPDATE `dede_archives` SET `body` = REPLACE(`body`, 'http://olddomain.com', 'http://newdomain.com'); -- 替换附加表中的旧域名(如果存在) UPDATE `dede_addonarticle` SET `body` = REPLACE(`body`, 'http://olddomain.com', 'http://newdomain.com'); -- 替换文档内容中的旧域名 UPDATE `dede_arctiny` SET `redirecturl` = REPLACE(`redirecturl`, 'http://olddomain.com', 'http://newdomain.com');
点击【查询】执行,执行完毕后,清除浏览器缓存,再访问网站即可。
-
| 项目 | 位置 | 重要性 | 示例 |
|---|---|---|---|
| 站点根网址 | 后台 -> 系统 -> 系统基本参数 -> 站点信息 | 极高 | https://www.yourdomain.com/ |
| 主页链接 | 后台 -> 系统 -> 系统基本参数 -> 站点信息 (或模板调用) | 高 | {dede:global.cfg_indexurl/} |
核心建议:
- 首次安装或迁移网站时,务必先设置好【站点根网址】。
- 在前台模板中,永远使用
{dede:global.cfg_indexurl/}或{dede:global.cfg_basehost/}/来链接首页,不要直接写死index.html或域名。
