海洋CMS安装教程

海洋CMS安装教程即通过下载源码包、配置服务器环境、导入数据库并完成安装向导,从而实现影视网站快速部署的完整操作流程。

环境准备

在开始安装之前，请确保你的服务器或虚拟主机满足以下基本环境要求,这是海洋CMS正常运行的基础。

• • 操作系统：Linux（推荐 CentOS 7+ / Ubuntu 18.04+）或 Windows Server，本教程以 CentOS 7 为例。
  • Web 服务器：Nginx（推荐）或 Apache，需开启 URL 重写模块。
  • PHP 版本：PHP 7.2 及以上，最高兼容到 PHP 8.1，必须开启以下扩展：
    • mysqli 或 pdo_mysql
    • curl
    • openssl
    • mbstring
    • gd（用于验证码和图片处理）
    • fileinfo
    • zip（用于在线更新和插件安装）
  • 数据库：MySQL 5.6 或更高版本，建议使用 MySQL 5.7 或 8.0,需创建独立的数据库和用户。
  • 推荐配置：内存不小于 1GB，剩余磁盘空间 5GB 以上。

你可以通过宝塔面板、LNMP 一键安装包或手动编译的方式来搭建上述环境，对于新手用户，宝塔面板可以大幅降低搭建难度，在宝塔中安装 Nginx、MySQL、PHP 后，需进入 PHP 设置——安装扩展中勾选并安装上述必备扩展，同时记得在“禁用函数”中删除 proc_open、putenv、symlink 等可能被海洋CMS用到的函数。

获取海洋CMS源码

1. 访问海洋CMS官方网站或官方 GitHub/Gitee 仓库，下载最新正式版源码包，通常文件名为 oceanCMS_Vx.x.x.zip 或 oceanCMS-master.zip。
2. 下载完成后，将压缩包上传至服务器网站目录，如果使用宝塔面板，网站目录默认为 /www/wwwroot/你的域名/；如果手动配置 LNMP，目录通常为 /home/wwwroot/你的域名/。
3. 使用 SSH 连接服务器，进入网站根目录，执行解压命令，假设你的网站根目录为 /www/wwwroot/example.com，压缩包存放在 /root 目录下,则执行：

cd/www/wwwroot/example.com
unzip-o/root/oceanCMS_V1.5.5.zip

4. 解压后，务必将所有文件和文件夹移动到根目录，避免文件被包裹在二级目录内，若解压后产生一个子文件夹，使用命令 mv 子文件夹/* . 和 mv 子文件夹/.* .（注意隐藏文件）将所有内容移至根目录,然后删除空子文件夹。
5. 设置目录权限，海洋CMS 需要 runtime、upload、public/install、template 等目录拥有读写权限，而 addons、application 等目录也需要在插件安装时可写，最直接的方式是设置整个项目的归属为 Web 服务器运行用户（如 www），并给予 755 权限：

chown-Rwww:www/www/wwwroot/example.com
chmod-R755/www/wwwroot/example.com

如果使用宝塔面板，通常在文件管理页面选中所有文件，点击“权限”按钮，设置所有者 www，权限 755，并勾选“应用到子目录”即可。

创建数据库

在安装向导开始前，需要预先建立 MySQL 数据库和数据库用户。

1. 登录 MySQL 管理工具（如 phpMyAdmin、宝塔数据库管理或命令行）。
2. 创建专用数据库，建议使用 utf8mb4 字符集和 utf8mb4_general_ci 排序规则，以完整支持 Emoji 和特殊字符。

CREATEDATABASEocean_cmsDEFAULTCHARACTERSETutf8mb4COLLATEutf8mb4_general_ci;

新建数据库用户并授权,务必使用复杂密码。

CREATEUSER'ocean_user'@'localhost'IDENTIFIEDBY'YourStrongPassword';
GRANTALLPRIVILEGESONocean_cms.*TO'ocean_user'@'localhost';
FLUSHPRIVILEGES;

记录数据库名、用户名和密码,后续安装向导会用到。

如果你的数据库与 Web 服务器不在同一台主机，请将 localhost 替换为数据库服务器 IP 或域名，并确保端口（默认 3306）已在防火墙放行，且 MySQL 用户允许远程连接。

配置 Web 服务器

为了让海洋CMS的伪静态和路由功能正常工作，需要设置 URL 重写规则。

Nginx 配置（推荐）在网站的 Nginx 配置文件中，找到 location / 区块,并加入以下重写规则：

location/{
if(!-e$request_filename){
rewrite^(.*)$/index.php?s=$1last;
break;
}
}

确保 PHP 解析配置正确,完整示例：

server{
listen80;
server_nameexample.com;
root/www/wwwroot/example.com;
indexindex.phpindex.html;
location/{
if(!-e$request_filename){
rewrite^(.*)$/index.php?s=$1last;
}
}
location~\.php${
fastcgi_pass127.0.0.1:9000;
fastcgi_indexindex.php;
fastcgi_paramSCRIPT_FILENAME$document_root$fastcgi_script_name;
includefastcgi_params;
}
location~/\.ht{
denyall;
}
}

保存后重启 Nginx 服务使配置生效。

Apache 配置确保启用了 mod_rewrite 模块，网站根目录下自带的 .htaccess 文件内容如下（若缺失可手动创建）：

<IfModulemod_rewrite.c>
Options+FollowSymlinks-Multiviews
RewriteEngineOn
RewriteCond%{REQUEST_FILENAME}!-d
RewriteCond%{REQUEST_FILENAME}!-f
RewriteRule^(.*)$index.php?s=$1[QSA,PT,L]
</IfModule>

IIS 或其他服务器请参考官方文档设置对应的 Rewrite 规则。

开始安装

环境就绪后，通过浏览器访问你的域名，系统会自动跳转到安装向导页面，通常为 http://你的域名/install.php 或直接访问域名进入。

1. 安装协议：仔细阅读海洋CMS使用协议，勾选“我已阅读并同意以上条款”，点击“下一步”。
2. 环境检测：系统会自动检测 PHP 版本、目录权限、扩展和函数是否满足要求，若出现红色 “×” 项，需返回修正，常见错误包括：
   • runtime 目录不可写：重新赋予 755 或 777 权限。
   • proc_open 等函数被禁用：解除禁用。
   • 缺少 fileinfo 扩展：安装后重启 PHP 服务。 所有项目显示绿勾后，点击“下一步”。
3. 数据库配置：填写之前创建的数据库信息。
   • 数据库服务器：一般填写 localhost，若使用远程数据库填 IP 地址。
   • 数据库端口：默认 3306。
   • 数据库名：ocean_cms
   • 数据库用户名：ocean_user
   • 数据库密码：你设置的强密码
   • 数据表前缀：默认 oc_，如需同数据库安装多套程序可修改，建议保持默认。 点击“测试连接”，确认连接成功后再点击“下一步”。
4. 创建管理员账号：设置后台管理员的用户名、密码和邮箱，密码务必使用字母、数字和特殊符号的组合，长度不少于 8 位，该账号将用于登录后台,管理全部网站设置和内容。
5. 安装执行：系统开始创建数据表、写入基础数据并生成配置文件，过程持续数秒至数十秒，切勿刷新或关闭页面，完成后会提示“安装成功”,并显示后台地址和前台首页链接。

强烈建议完成安装后删除安装文件，以避免安全隐患，删除服务器上的 public/install 目录及根目录下的 install.php（如果存在）：

rm-rf/www/wwwroot/example.com/public/install
rm-f/www/wwwroot/example.com/install.php

部分版本安装脚本在安装结束后会自动锁定,但仍需手动清理安装目录以确保绝对安全。

完成后的基础配置

安装成功并进入后台后，需要立即完善几项基础设置,让你的站点尽快投入正式运行。

• 系统设置：在“系统—网站配置”中，填写网站名称、首页标题、SEO关键词和描述，选择模板方案，并设置上传方式及附件大小限制，如果使用云存储，可在“上传设置”中选择对应的驱动并填写密钥。
• URL 模式设置：在“系统—URL 设置”中，选择路由模式，推荐使用“PATH_INFO”模式，或搭配 Nginx 伪静态使用“短路由”模式，可大幅提升链接的友好度和 SEO 表现，更改后系统会自动生成新的路由规则,务必清缓存。
• 定时任务配置：海洋CMS的采集、数据更新、生成静态等功能依赖定时任务，在服务器 crontab 中添加如下计划,确保数据自动同步：

*****php/www/wwwroot/example.com/thinkqueue:listen--queue=collect--tries=3

如果使用宝塔面板，可在计划任务中新增 Shell 脚本类型，执行上述命令，后台的“系统—定时任务”中要开启对应任务的开关,并检查运行日志。

• 安全加固：修改后台入口文件名（将 admin.php 重命名为不易猜测的名称，并在配置文件中更新），开启后台验证码，设置登录失败锁定策略，定期更新海洋CMS到最新版本,修复已知漏洞。
• 模板安装与调试：在“模板—模板市场”或官方论坛中选取适合的模板下载，通过后台上传模板包导入，激活模板后预览前台，根据需求调整模块调用和显示选项，对于自定义开发,可利用海洋CMS的标签系统和模板继承来构建页面。
• 播放器与资源站对接：海洋CMS的强大之处在于丰富的资源站接口，在“资源—资源站”中添加如天堂、最大、酷播等资源站的 API 地址，配置好分类映射，一键自动采取并同步数据，首次建议使用“绑定分类并采集当天数据”进行测试,确认无误后再全量同步。

完成以上步骤，你的海洋CMS影视网站就已部署完成，可以开始发布文章、导入影片数据并进行精细化运营。