Isso
轻量级自托管评论服务器,替代 Disqus,支持 Markdown、SQLite 后端,隐私友好。
智能下载
前往项目主页
该项目暂未提供安装包,请直接访问源代码仓库
自托管评论系统,比 Disqus 轻量,隐私安全,一键嵌入。
核心功能
- 评论支持 Markdown 排版
- 使用 SQLite 数据库,无需复杂配置
- 15分钟内可编辑或删除自己的评论
- 可导入 Disqus / WordPress 已有评论
- JavaScript 客户端仅 65kB,加载飞快
避坑指南
- •默认评论编辑/删除时限为15分钟,可配置调整。2. 邮件通知需额外配置 SMTP。3. Docker 镜像标签从 :latest 变更为 :release,注意更新。4. 仅支持 SQLite,不适合高并发大型站点。
适用场景
- 为静态博客(如 Hugo、Jekyll)添加评论功能
- 替代 Disqus,避免第三方跟踪和广告
- 个人网站或小团队项目的评论区
详细介绍
Isso(Ich schrei sonst)是一个开源自托管的评论系统,旨在作为 Disqus 的直接替代品。它用 SQLite 存储评论(不搞大数据噱头),支持 Markdown 格式,用户可在15分钟内编辑或删除自己的评论。JavaScript 客户端仅65 kB(gzip后20 kB),嵌入简单。支持从 Disqus 或 WordPress 导入现有评论。只需 Python 3.8+ 和 SQLite 即可运行,也提供 Docker 镜像。Isso 注重隐私和简洁,非常适合静态网站、博客和个人项目。
常见问题与排障 (2)
故障排除如何在Python 3.13或3.14上运行Isso时修复'No module named pkg_resources'错误?
此错误发生是因为 Python 3.13+ 附带了较新的 setuptools,其中移除了已弃用的 pkg_resources 模块。临时解决方案:使用 pip install setuptools==81.0.0 将 setuptools 固定在 81.0.0 版本。永久修复:将 Isso 升级到 0.14.0 或更高版本,这些版本不再依赖 pkg_resources。
故障排除如何在 pip install Isso 0.13.2 后修复缺失的 embed.min.js?
问题在于embed.min.js文件未包含在Isso 0.13.2的PyPI包中。解决方法:要么使用esbuild手动构建该文件:运行 esbuild --minify --alias:app=./app --loader:.svg=dataurl --bundle embed.js --outfile=embed.min.js(可能需要先安装esbuild,例如通过Debian仓库或npm)。或者降级至包含该文件的Isso 0.13.0,使用 pip install isso==0.13.0。此错误已在版本0.14.0中修复。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
确保安装 Python 3.8+ 和 pip,并确认 SQLite 可用
执行命令:pip install isso
创建配置文件 isso.cfg(参考官方文档)
- 确保安装 Python 3.8+ 和 pip,并确认 SQLite 可用
- 执行命令:pip install isso
- 创建配置文件 isso.cfg(参考官方文档)
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载,并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
执行 pip uninstall isso 即可卸载。若使用 Docker,删除容器和镜像。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
2 FAQs