先别急着改模板、换主题，更别去折腾那些花里胡哨的插件——你辛辛苦苦采集来的视频、图片、字幕，最后能不能正常在前台播放、显示，全看“附件设置”这一关，很多新手站一换服务器或者一配云存储就白屏、图片裂掉，十有八九是这里没搞明白，今天咱们就按步骤，一步一步把苹果CMS的附件设置捋清楚，你跟着操作，不用懂代码，也能把网站的视频和图片稳稳当当地存起来、挂出去。
适用人群：正在用苹果CMS搭建影视站、短视频站、资源站的新手站长；用过但总在附件上传/读取上出问题的人；想把附件从服务器挪到阿里云OSS或腾讯云COS的进阶用户；以及那些刚迁完主机,发现后台附件全部404的可怜人。
完整搭建步骤（以苹果CMS V10为例）
第一步：进入后台，找到“系统-附件设置”。
这是所有附件相关配置的总入口，左侧菜单里“系统”下面有个“附件设置”，点进去你会看到三个Tab：“上传配置”“存储配置”“URL配置”,咱们一个一个来。
第二步：配置“上传配置”
苹果CMS附件设置从零到精通，本地与远程存储配置实战（新手照做就能跑通）
- 上传目录：默认是
/upload，建议保持默认，如果你改了，记得后面的存储配置里目录也要同步改。 - 允许类型：这里写你要允许上传的文件后缀，图片一般留
jpg,jpeg,png,gif,webp，视频如果是小片段测试可以加mp4,webm,ogg，千万别把php、htm加进去，这是找死行为。 - 上传大小：根据你的服务器或云存储限额来填，单位是KB，比如你想限制不能超过50MB，就写
51200。 - 水印设置：如果希望新上传的图片自动带水印，把“开启水印”设为“是”，然后上传一张PNG水印图，透明度拉到合适位置，注意，这里只对图片生效,不影响视频。
第三步：配置“存储配置”
这是苹果CMS附件设置的核心，默认是“本地存储”，也就是文件直接存到你服务器这个网站目录下，新手初期用本地存储就行，但记住两点：一是确认/upload目录存在，并且有写入权限（权限值要0755或0777）；二是如果你用了云存储，这里要切换成对应的插件。
以阿里云OSS为例：存储配置选“阿里云OSS”，然后填三样东西：
- AccessKeyId 和 AccessKeySecret：去阿里云控制台RAM里创建，只给这个OSS的读写权限，别用主账号密钥。
- Bucket名称：你创建的存储桶名字，注意不带后缀。
- 访问域名：如果你是外网访问，填
你的Bucket.oss-区域.aliyuncs.com；如果你绑定了自定义域名并做了CDN，填你的自定义域名，比如cdn.example.com。
填好后点“测试保存”，成功会提示“连接成功”，腾讯云COS、七牛云、又拍云同理。
第四步：配置“URL配置”
这里决定前台访问附件的链接长什么样。
- 本地存储时，URL地址默认为
/upload，也就是最终图片地址是https://你的域名/upload/202504/xx.jpg。 - 云存储时，URL地址必须填成你在云存储里设置的公网访问前缀，比如你OSS里的资源根目录是
/upload，且绑定了CDN域名https://cdn.example.com，那URL就填https://cdn.example.com/upload。
注意：这一步最容易出错——如果填错了，后台上传成功，但前台图片全部打不开,因为浏览器去访问了一个不存在的路径。
第五步：保存并测试
所有配置完成后，点击“保存”，然后去“素材-图片上传”传一张测试图，或者发一篇采集文章带图，再回到前端页面按F12查看图片地址是否按你设置的URL输出,去服务器上或OSS控制台确认文件确实存在了。
配置要点（记不住就收藏）
- 路径必须统一：上传目录、存储目录、URL前缀三者的“相对路径”要一致，比如上传目录填了
/upload，云存储Bucket根目录下的文件夹也建议叫upload，URL前缀最后也要带/upload，否则会拼出错误链接。 - 域名匹配：前台用的是哪个域名，附件URL最好也用哪个域名，不然会跨域导致某些浏览器拒绝加载，如果用了CDN，CDN的源站回源地址要填对你的服务器域名或OSS公网地址。
- 水印和缩略图：苹果CMS支持生成缩略图参数，在“上传配置”里可以设置“缩略图宽高”，如果你用了云存储，缩略图只能靠代码生成，可能增加额外流量，建议本地存储时开启，云存储时关闭，用云服务商自带的图片处理服务。
- 防盗链：在云存储控制台开启防盗链（Referer白名单），把你的站点域名加进去，如果不想管得太细，可以留空，默认允许所有来源,但容易被别人盗图盗资源。
常见踩坑提醒（新手必看）
-
坑一：上传提示“无法写入文件”
90%是目录权限问题，用FTP工具或宝塔文件管理器，把/upload目录权限改为755，如果是Windows主机，要给网站运行用户（IIS用户或www用户）读写权限，别直接777,有安全风险。 -
坑二：配置了OSS，但前台图片变成
/upload/xxx.jpg没域名前缀
这说明URL配置里没填或填错，重新检查“附件设置-存储配置”里的“访问域名”和“URL配置”里的“URL地址”，确保以http(s)://或开头,且结尾不要多一个斜杠。 -
坑三：明明在OSS里能看到文件，但前台播放视频404
大概率是视频文件上传时被苹果CMS改名了，而OSS上开启了“禁止文件后缀名访问”或“私有读写”，解决方案：OSS Bucket权限设为“公共读”，或者用防盗链而不是私有读写，检查“上传配置”里是否把视频格式加了进来,没加的话视频根本传不上去。 -
坑四：切换云存储后，老数据全部失效
这是最坑的，你原来是本地存储，换成OSS后，以前上传的附件还在服务器上，但URL配置已经改成CDN域名，前台读取旧图片时会去CDN找，结果404，解决办法：要么等CDN/OSS的“回源”功能自动拉取（需要你把服务器域名的回源路径设置对），要么把旧附件迁移到OSS去，苹果CMS里没有一键迁移工具，你可以用OSS的批量上传工具把/upload目录整个传上去。 -
坑五：后台列表不显示图片缩略图
有时候是缓存问题，清一下苹果CMS的后台缓存（工具-清理缓存），如果还不行，检查“上传配置”里的“缩略图宽高”是否设置成了0，0会关闭缩略图生成，但列表里应该显示原图才对，这个一般是模板在调用时用的字段不对，但更常见的是你URL配置错了,图片加载不出来。
最后给你一个万能调试法：随便找一张后台能正常上传的图片，右键复制图片地址，然后在浏览器新标签页打开，如果打不开，看浏览器地址栏的域名和路径，再去对照你的配置哪里不一致，如果打开了，但前台页面不行，多半是模板问题,跟附件设置就无关了。
照上面这套流程走一遍，你的苹果CMS附件设置就基本稳了，以后不管换域名、加CDN、挪云存储，都能顺着这个思路排查,不会再瞎折腾到半夜。
发表评论