0

0

如何禁用 Django CKEditor 4 的安全版本警告提示

碧海醫心

碧海醫心

发布时间:2026-01-21 17:23:21

|

381人浏览过

|

来源于php中文网

原创

如何禁用 Django CKEditor 4 的安全版本警告提示

本文详解在 django 项目中(使用 django-ckeditor 6.7.0)彻底关闭 ckeditor 4.22.1+ 版本升级提醒(如“this ckeditor 4.22.1 version is not secure…”)的正确方法,重点说明 `config.versioncheck = false` 的配置位置与生效机制。

CKEditor 4 自 4.22.0 版本起引入了内置的版本安全性检查机制,会在编辑器初始化时自动向官方 CDN 发起请求,比对当前加载版本与最新 LTS 版本,并在工具栏右下角弹出醒目的黄色警告提示(例如:“This CKEditor 4.22.1 version is not secure. Consider upgrading to the latest one, 4.24.0-lts.”)。该行为无法通过 Django 层面的 CKEDITOR_UPDATE_NOTIFICATION = False 或 CKEditor 配置项 updateCheck: false / ignoreUpdates: true 关闭——因为这些参数在 CKEditor 4.22+ 中已被弃用或未被正确识别。

✅ 正确且唯一可靠的禁用方式是:在 CKEditor 的 JavaScript 运行时配置中显式设置 config.versionCheck = false

由于你使用的是 django-ckeditor,其底层仍基于 CKEditor 4 的原生 JS 加载逻辑,因此需将该配置注入到最终生成的 CKEditor 初始化脚本中。操作步骤如下:

造梦阁AI
造梦阁AI

AI小说推文一键成片,你的故事值得被看见

下载
  1. 修改 CKEDITOR_CONFIGS 配置,在 "default"(或其他启用的配置名)下添加 versionCheck: false(注意:不是字符串 "versionCheck",而是布尔值 false):
CKEDITOR_CONFIGS = {
    "default": {
        "skin": "moono",
        "toolbar": "Custom",
        "allowedContent": True,
        "extraAllowedContent": "object[id,name,width,height];",
        "extraPlugins": "iframe",
        "iframe_attributes": {
            "sandbox": "allow-scripts allow-same-origin allow-popups allow-presentation allow-forms",
            "allowfullscreen": "",
            "loading": "lazy",
            "referrerpolicy": "no-referrer-when-downgrade",
        },
        # ✅ 关键新增:禁用版本检查(必须为小写 false,且位于顶层 config 对象)
        "versionCheck": False,  # ← 此处为 Python bool,django-ckeditor 会自动转为 JS false
        # 其余原有配置保持不变...
        "toolbar_Custom": [ ... ],
        "language": "en",
    }
}
⚠️ 注意事项:versionCheck: false 必须作为 CKEditor 配置对象的一级键(top-level property),不能嵌套在 toolbar_XXX 或其他子对象中;在 django-ckeditor 中,Python 的 False 会被正确序列化为 JavaScript 的 false,无需写成字符串 "false";旧参数如 "updateCheck": False、"ignoreUpdates": True 或 CKEDITOR_UPDATE_NOTIFICATION = False 均无效,请移除以避免干扰;此设置仅禁用警告提示,不会升级 CKEditor 文件本身。若需真正提升安全性,建议后续手动升级 django-ckeditor 并同步更新其内置的 CKEditor 4 资源(如升级至支持 CKEditor 4.24.0-lts 的新版)。
  1. 清理浏览器缓存并重启 Django 开发服务器,访问 Admin 页面验证:警告条应完全消失,且编辑器功能不受影响。

? 补充说明:该机制本质是 CKEditor 4 内部通过 CKEDITOR.config.versionCheck 控制是否执行 checkVersion() 异步请求。设为 false 后,相关网络请求(如 https://cdn.ckeditor.com/.../version-check.json)将被跳过,从根源消除提示。

总结:禁用 CKEditor 4 安全警告的核心是 versionCheck: false —— 简洁、有效、兼容所有 django-ckeditor ≥ 5.x 版本。请优先确保配置位置正确,并配合实际版本升级计划,兼顾开发体验与长期安全性。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

769

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

661

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

764

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

639

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1325

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

549

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

709

2023.08.11

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

7

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.3万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号