documentroot 是 apache 中定义网站根目录的核心参数,需将其设为静态资源所在路径(如 /home/wwwroot),并同步配置对应 权限、selinux 上下文及文件系统权限,最后重启服务验证。

DocumentRoot 是 Apache 中定义网站根目录的核心参数,它告诉服务器“用户访问网站时,默认从哪个文件夹里找文件”。配置静态资源目录,本质就是把 DocumentRoot 指向你存放 HTML、CSS、JS、图片等静态文件的目录。
确认目标目录并准备文件
先确保你的静态资源已就位,比如放在 /home/wwwroot 或 /var/www/my-site。目录内至少应有 index.html(或按 DirectoryIndex 设置的其他默认页)。执行命令创建示例:
- mkdir -p /home/wwwroot
- echo "
My Static Site
" > /home/wwwroot/index.html
修改主配置文件中的 DocumentRoot 和对应 Directory 权限
编辑主配置文件 /etc/httpd/conf/httpd.conf(RHEL/CentOS)或 /etc/apache2/sites-available/000-default.conf(Debian/Ubuntu),找到并修改两处关键配置:
- 将 DocumentRoot 的值改为你的目录路径,例如:
DocumentRoot "/home/wwwroot" - 紧接着找到或添加对应的
块,路径必须与 DocumentRoot 完全一致:
AllowOverride None
Require all granted
⚠️ 注意:DocumentRoot 在整个配置中只能出现一次(全局生效),不能在
处理 SELinux 和文件权限(常见报错根源)
即使配置正确,也可能因安全机制返回 403 错误。需同步检查:
-
SELinux 上下文:运行 ls -Z /home/wwwroot,若类型不是 httpd_sys_content_t,则执行:
semanage fcontext -a -t httpd_sys_content_t "/home/wwwroot(/.*)?"
restorecon -Rv /home/wwwroot -
文件系统权限:确保 Apache 进程用户(如 apache 或 www-data)对目录有读取和执行(x)权限:
chmod 755 /home/wwwroot
chown -R root:apache /home/wwwroot
重启服务并验证
保存配置后,依次执行:
- systemctl restart httpd(RHEL/CentOS)或 systemctl restart apache2(Debian/Ubuntu)
- 检查状态:systemctl status httpd 确保无报错
- 浏览器访问服务器 IP,确认显示你写的 index.html 内容











