第三章运行环境与目录

Ju7CMS 用户手册 · 发布于 2026-10-27 · 更新于 2026-10-27

服务器要满足的五个条件、Access 数据库的固定路径、顶层目录清单与哪些不能删；换服务器前照着核对一遍。

服务器要满足的五个条件

Ju7CMS 是 Classic ASP 程序，跑在 IIS 上，数据放在一个 Access 文件里。服务器只要有一个条件不满足，表现往往不是一条明确的报错，而是整站打不开或某个功能悄悄失效。

条件	怎么算满足	不满足时看到的现象
IIS 已启用 ASP	「应用程序开发」里勾了 ASP，处理程序里能看到 .asp 映射	访问页面被直接下载成文件，或返回 500.50
应用程序池启用 32 位	池的「启用 32 位应用程序」为 True，且服务器装了对应的 Access 驱动	「未在本地计算机上注册 Microsoft.Jet.OLEDB.4.0 提供程序」，全站 500
ASP 父路径已启用	ASP 设置里的「启用父路径」为 True	`comment/`、分站目录等含 `../../` 的页面 500，首页却正常
五个目录可写	IIS 工作进程账号对 `data\`、`cache\`、`upfile\`、`log\`、`data\databackup\` 有修改权限	后台保存报错、上传失败、整页缓存写不进去
默认文档为 index.asp	站点的默认文档列表里 `index.asp` 排在前面	打开域名显示目录列表或 403

程序在 andvar.asp 开头把脚本超时设成 300 秒、编码设成 UTF-8。这两项不用在 IIS 里另外配，但改 andvar.asp 时要保留它们。

Access 版的库文件固定是 data/#Andvar_com.mdb，路径写在 lib/class/andvar.db.asp 里，不是后台设置项。换目录、改文件名都必须改代码，只改文件名会让全站打不开。

连接时会按 ACE 16 → ACE 12 → Jet 4.0 的顺序逐个尝试，哪个驱动装了就用哪个。都不行时页面只显示「系统维护中，请稍后再试」，同时把失败原因写进错误记录。看到这行字，先确认库文件在不在、驱动装没装，别急着重装程序。

备份这个站，本质是两件事：拷程序目录 + 拷 data/。只拷程序不拷 data/，恢复出来是一个空站；只拷 data/ 不拷程序，版本对不上时数据库里的新字段会读不出来。

目录 / 文件	里面是什么
`andvar.asp`	站点总配置：`webroot`、`theme_root`、站点名、默认 SEO、分站变量。每个分站目录里还有一份自己的
`index.asp`	首页入口，负责把请求交给首页模板
`lib/`	程序内核：`base.asp`、`show.asp`、`list.asp`、`cmd.asp`；`class/` 下是模板引擎、数据库、上传等基础类
`ju7/`	后台。一个 `.asp` 对应一个功能页，`_layout_top.asp` 与 `_layout_bottom.asp` 是后台外壳
`manage/`	后台工作台的右侧内容（`right.html`）与公共样式脚本
`theme/`	主题目录。`theme_root` 指向哪一个，前台就用哪一个；本站是 `576so`
`plug/`	插件，一个子目录一个插件，装卸见第二十一章
`data/`	数据库、`databackup/`（备份）、`migrations/`（结构迁移）、`pkgtmp/` 与 `upgrade_bak/`（升级临时件）
`cache/`	`theme/` 模板编译产物、`html/` 整页缓存。随时可清
`upfile/`	上传的图片与附件，按年月分目录
`log/`	数据库层的日志文件（`db_日期.log`），与后台「错误记录」不是一回事
`block/`	区块模板目录。本站为空，机制可用但未启用，见第三十一章
`search/` `comment/`	站内搜索与评论的入口壳，复用主站程序
九个拼音目录	`JIAOJIANG`、`HUANGYAN` 等地区分站入口，见第二十二章
`sitemap1.xml` `robots.txt` `llms.txt` `city.xml`	给搜索引擎和外部工具读取的静态文件，改完直接覆盖即可，不需要清缓存

对象	能不能动	说明
`cache/` 下的文件	随时可清	清掉只会让下一次访问变慢，后台「缓存管理」也是一次清这里
`log/` 下的日志	可以清	先确认没有正在排查的问题，再按日期删旧的
`data/databackup/`	只删旧的	至少留最近三份，见第三十九章
`upfile/` 下的文件	不要手删	可能仍被内容引用。要清就用「附件管理」，见第二十四章
`data/#Andvar_com.mdb`	不能删	整站内容都在这一个文件里
`theme/` 当前主题	不能删	删了前台没有样式甚至打不开；替换主题按第三十五章做
`lib/` `ju7/` `plug/`	不能随意删	删一个文件可能让某个功能整页 500，改之前先备份

目录改名、换库文件名、把站放到子目录，都属于「改结构」，不是搬家。这些动作要同时改 andvar.asp 与数据库路径代码，做之前先看第三十八章的升级与回滚口径。