木漏茶室源码下载中心
整站 PHP 源码:可浏览文件、复制路径、下载单文件或打包 ZIP。
发布版本 v6.25.231
升级后自动生成独立源码包,下载中心只发送这份冻结包
已排除 config.php / 用户数据 / 上传文件 / 升级备份
COMMUNITY DEPLOYMENTS
已经跑起来的木漏茶室
从源码下载中心下载、完成安装并回传验证的站外站点。每个站点只计 1 次部署下载量;已记录站点会实时读取名称、版本、Logo 与在线状态,本机、内网和证书异常站点无法完成回传。
实时检测
2
个站点已部署
木
木漏茶室
mlcs.xnn.lol · v6.25.232
访问 ↗
2026.11.21
在线
木
木漏茶室
mlcs.nbnb.mom · v6.25.231
访问 ↗
2026.11.20
在线
已展示全部 2 个站点。
pages/deploy.php
17.6 KB · 发布包 v6.25.231
<?php
/**
* 扩展中心 · 一键部署:生成云服务器 / 宝塔面板可执行的部署命令。
*/
require_once APP_ROOT . '/inc/deploy_center.php';
require_once APP_ROOT . '/inc/source_release.php';
$act = (string) input('act', '');
// ---------- 下载部署脚本 / 源码包(凭签名令牌,不要求登录) ----------
if ($act === 'script' || $act === 'package') {
$token = (string) ($_GET['token'] ?? '');
$payload = deploy_center_parse_token($token);
if (!is_array($payload)) {
http_response_code(403);
header('Content-Type: text/plain; charset=utf-8');
exit('部署令牌无效或已过期,请回到扩展中心重新生成。');
}
$release = deploy_center_release_meta();
if (!is_array($release) || empty($release['path']) || !is_file((string) $release['path'])) {
http_response_code(503);
header('Content-Type: text/plain; charset=utf-8');
exit('源码发布包尚未生成,请稍后再试。');
}
if (($payload['h'] ?? '') !== (string) ($release['sha256'] ?? '')) {
http_response_code(409);
header('Content-Type: text/plain; charset=utf-8');
exit('源码包已更新,请回到扩展中心重新生成部署命令。');
}
if ($act === 'script') {
deploy_center_send_script($token, $payload);
}
$path = (string) $release['path'];
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="komorebi-forum-v' . preg_replace('/[^0-9A-Za-z_.-]/', '', (string) $release['version']) . '-source.zip"');
header('Content-Length: ' . filesize($path));
header('X-Content-SHA256: ' . (string) $release['sha256']);
header('Cache-Control: no-store, no-cache, must-revalidate');
readfile($path);
exit;
}
$me = current_user();
if (!is_superadmin($me)) {
http_response_code(403);
render_header('一键部署');
echo '<section class="auth-wrap"><div class="auth-card"><h1>无权访问</h1><p class="muted">一键部署仅超级管理员可用。</p><p><a class="btn ghost" href="' . e(page_url('extensions')) . '">返回扩展中心</a></p></div></section>';
render_footer();
exit;
}
if (source_center_host_restricted()) {
http_response_code(404);
render_header('页面不存在');
echo '<section class="auth-wrap"><div class="auth-card"><h1>页面不存在</h1></section>';
render_footer();
exit;
}
$release = deploy_center_release_meta();
$error = '';
$command = '';
$token = '';
$expireAt = 0;
$defaultDir = '/www/wwwroot/mlcs';
$defaultSite = (($_SERVER['HTTPS'] ?? '') === 'on' ? 'https://' : 'http://') . ($_SERVER['HTTP_HOST'] ?? 'localhost');
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
check_csrf();
$dir = trim((string) ($_POST['dir'] ?? ''));
$site = trim((string) ($_POST['site'] ?? ''));
if ($dir === '') {
$dir = $defaultDir;
}
if (!preg_match('#^/[A-Za-z0-9_\-./]+$#', $dir) || strpos($dir, '..') !== false) {
$error = '安装目录只能使用绝对路径,且只允许字母、数字、下划线、短横线、点和斜杠,例如 /www/wwwroot/mlcs';
} elseif (!preg_match('#^https?://[^\s"\'<>]+$#i', $site)) {
$error = '站点地址需要以 http:// 或 https:// 开头';
} elseif (!is_array($release)) {
$error = '源码发布包尚未生成,暂时无法部署';
} else {
$token = deploy_center_make_token($dir, rtrim($site, '/'), 1800);
$payload = deploy_center_parse_token($token);
$expireAt = (int) ($payload['e'] ?? 0);
$scriptUrl = deploy_center_script_url($token);
$command = 'curl -fsSL "' . $scriptUrl . '" -o /tmp/km-deploy.sh && bash /tmp/km-deploy.sh';
}
}
if (!is_array($release)) {
$releaseError = '源码发布包尚未生成,请先进入源码下载中心触发一次发布。';
}
render_header('一键部署');
?>
<section class="deploy-hero">
<span class="hero-kicker">ONE-CLICK DEPLOY</span>
<h1>一键部署</h1>
<p>在云服务器终端或宝塔面板执行一条命令,自动下载本站最新源码、校验完整性、解压、写入配置并初始化数据库。</p>
</section>
<section class="panel deploy-panel">
<div class="panel-head">
<h2 class="section-title">部署包状态</h2>
<span class="muted">只读取源码下载中心的冻结发布包</span>
</div>
<?php if (is_array($release)): ?>
<div class="deploy-meta">
<div><span>当前版本</span><strong>v<?= e($release['version']) ?></strong></div>
<div><span>文件数量</span><strong><?= (int) ($release['file_count'] ?? 0) ?></strong></div>
<div><span>压缩包大小</span><strong><?= e(number_format(((int) ($release['total_size'] ?? 0)) / 1024 / 1024, 2)) ?> MB</strong></div>
<div class="wide"><span>SHA256</span><strong class="mono"><?= e($release['sha256']) ?></strong></div>
</div>
<?php else: ?>
<p class="deploy-error"><?= e($releaseError ?? '源码发布包尚未生成') ?></p>
<?php endif; ?>
</section>
<section class="panel deploy-panel">
<div class="panel-head">
<h2 class="section-title">生成部署命令</h2>
<span class="muted">命令 30 分钟内有效,过期需重新生成</span>
</div>
<?php if ($error): ?><p class="deploy-error"><?= e($error) ?></p><?php endif; ?>
<form method="post" class="deploy-form">
<?= csrf_field() ?>
<div class="field-row">
<label class="field grow">
<span>服务器安装目录</span>
<input type="text" name="dir" value="<?= e($_POST['dir'] ?? $defaultDir) ?>" placeholder="/www/wwwroot/mlcs" autocomplete="off">
<small class="field-tip">宝塔面板一般是 /www/wwwroot/你的站点目录;必须使用绝对路径。</small>
</label>
<label class="field grow">
<span>部署完成后的站点地址</span>
<input type="text" name="site" value="<?= e($_POST['site'] ?? $defaultSite) ?>" placeholder="https://mlcs.xnn.lol" autocomplete="off">
<small class="field-tip">用于部署完成后的访问提示,不参与下载校验。</small>
</label>
</div>
<button class="btn-primary" type="submit">生成一键部署命令</button>
</form>
<?php if ($command !== ''): ?>
<div class="deploy-command-box">
<div class="deploy-command-head">
<strong>在云服务器终端或宝塔面板「终端」中执行</strong>
<span class="muted">有效期至 <?= e(date('Y-m-d H:i', $expireAt)) ?></span>
</div>
<div class="deploy-command">
<textarea id="deployCommand" rows="3" readonly><?= e($command) ?></textarea>
<button type="button" class="btn-mini" id="deployCopy" data-copy-target="deployCommand">复制命令</button>
</div>
<small class="field-tip">如果当前登录用户不是 root,请在命令前加 <code>sudo</code>;执行过程中会提示填写数据库和管理员信息。</small>
</div>
<details class="deploy-details">
<summary>宝塔面板 / 无人值守部署(环境变量写法)</summary>
<p class="muted">适合面板计划任务或自动化脚本。把下面的值改成自己的数据库信息后,整段粘贴执行;密码不会写进本页面生成的命令。</p>
<pre>KM_DIR=/www/wwwroot/mlcs \
KM_DB_DRIVER=mysql KM_DB_HOST=127.0.0.1 KM_DB_PORT=3306 \
KM_DB_NAME=komorebi KM_DB_USER=komorebi KM_DB_PASS='你的数据库密码' \
KM_SITE_NAME='木漏茶室' KM_ADMIN_USER=admin KM_ADMIN_PASS='你的管理员密码' \
bash /tmp/km-deploy.sh</pre>
<p class="muted">SQLite 模式只需要设置 <code>KM_DB_DRIVER=sqlite</code>,其余数据库变量可省略。</p>
</details>
<?php endif; ?>
</section>
<section class="panel deploy-tutorial" id="deployTutorial">
<div class="panel-head deploy-tutorial-head">
<h2 class="section-title">使用教程</h2>
<div class="deploy-tabs" role="tablist">
<button type="button" class="deploy-tab is-on" data-deploy-tab="video" role="tab" aria-selected="true">视频教程</button>
<button type="button" class="deploy-tab" data-deploy-tab="guide" role="tab" aria-selected="false">图文教程</button>
</div>
</div>
<div class="deploy-tab-pane" id="deployTabVideo" role="tabpanel">
<div class="deploy-video-wrap">
<video controls preload="metadata" playsinline poster="<?= e(asset('img/deploy-guide/02-deploy.webp')) ?>">
<source src="<?= e('https://aka.doubaocdn.com/s/fYaOIPul1Z') ?>" type="video/mp4">
当前浏览器不支持视频播放,请使用下方图文教程。
</video>
</div>
<p class="deploy-video-caption">约 1 分 26 秒,豆包“阳光甜妹”配音讲解。按宝塔面板实操顺序演示:添加站点 → 生成命令 → 终端执行 → 选择 SQLite → 填写管理员 → 进入木漏茶室论坛。</p>
</div>
<div class="deploy-tab-pane" id="deployTabGuide" role="tabpanel" hidden>
<div class="deploy-guide-steps">
<article class="deploy-guide-step">
<span class="deploy-guide-num">01</span>
<div class="deploy-guide-body">
<h3>宝塔面板添加站点</h3>
<p>登录宝塔面板,打开「网站」→「添加站点」。域名填 <code>mlcs.xnn.lol</code>,根目录填 <code>/www/wwwroot/mlcs</code>,FTP 选「不创建」,数据库选「不创建(使用 SQLite)」,PHP 版本选 8.2。提交后不要手动放源码,下一步的命令会自动写入。</p>
<figure><img src="<?= e(asset('img/deploy-guide/01-extensions.webp')) ?>" alt="宝塔面板添加站点弹窗" loading="lazy"><figcaption>数据库选择「不创建」,后面由安装器创建 SQLite 文件</figcaption></figure>
</div>
</article>
<article class="deploy-guide-step">
<span class="deploy-guide-num">02</span>
<div class="deploy-guide-body">
<h3>扩展中心生成部署命令</h3>
<p>用超级管理员登录木漏茶室,进入「扩展中心」→「一键部署」。安装目录填宝塔站点根目录 <code>/www/wwwroot/mlcs</code>,站点地址填 <code>https://mlcs.xnn.lol</code>,点「生成一键部署命令」。命令 30 分钟内有效,复制整条。</p>
<figure><img src="<?= e(asset('img/deploy-guide/02-deploy.webp')) ?>" alt="一键部署生成命令页面" loading="lazy"><figcaption>安装目录必须和宝塔站点根目录一致</figcaption></figure>
</div>
</article>
<article class="deploy-guide-step">
<span class="deploy-guide-num">03</span>
<div class="deploy-guide-body">
<h3>在宝塔终端执行命令</h3>
<p>打开宝塔左侧「终端」,确认当前用户是 root,粘贴命令后回车。脚本会自动下载本站当前完整源码包、校验 SHA256、备份旧源码并解压到站点目录。非 root 用户请在命令前加 <code>sudo</code>。</p>
<figure><img src="<?= e(asset('img/deploy-guide/03-command.webp')) ?>" alt="宝塔终端执行一键部署命令" loading="lazy"><figcaption>出现 SHA256 校验通过即表示源码包完整</figcaption></figure>
</div>
</article>
<article class="deploy-guide-step">
<span class="deploy-guide-num">04</span>
<div class="deploy-guide-body">
<h3>数据库类型输入 sqlite</h3>
<p>首次安装会依次询问数据库类型、站点名称、管理员账号、密码和邮箱。数据库类型默认是 mysql,<strong>这里手动输入 <code>sqlite</code></strong>,安装器会把数据库写到 <code>data/komorebi.sqlite</code>,不需要在宝塔里另建数据库。随后设置站点名称「木漏茶室」和管理员密码即可。</p>
<figure><img src="<?= e(asset('img/deploy-guide/04-terminal.webp')) ?>" alt="终端选择 SQLite 并填写管理员" loading="lazy"><figcaption>输入 sqlite 后,按提示填写站点与管理员信息</figcaption></figure>
</div>
</article>
<article class="deploy-guide-step">
<span class="deploy-guide-num">05</span>
<div class="deploy-guide-body">
<h3>确认部署结果与目录权限</h3>
<p>看到「部署完成」和「config.php 已就绪」后,打开宝塔「文件」进入 <code>/www/wwwroot/mlcs</code>,确认 <code>config.php</code> 与 <code>data</code> 目录存在,所有者是 <code>www</code>、权限 755。若首页提示无法写入,把 <code>data</code>、<code>storage</code>、<code>uploads</code> 改为可写。</p>
<figure><img src="<?= e(asset('img/deploy-guide/05-success.webp')) ?>" alt="宝塔文件管理确认部署文件" loading="lazy"><figcaption>config.php 已生成,data 目录用于存放 SQLite 数据库</figcaption></figure>
</div>
</article>
<article class="deploy-guide-step">
<span class="deploy-guide-num">06</span>
<div class="deploy-guide-body">
<h3>访问域名进入论坛</h3>
<p>浏览器打开 <code>https://mlcs.xnn.lol</code>,能看到「木漏茶室」首页和板块列表即部署成功。用第 4 步填写的管理员账号登录后台,检查发帖、上传和扩展中心是否正常。已有站点更新时会保留 <code>config.php</code>、上传文件和运行数据。</p>
<figure><img src="<?= e(asset('img/deploy-guide/06-forum.webp')) ?>" alt="部署完成后的木漏茶室论坛首页" loading="lazy"><figcaption>部署完成后的木漏茶室论坛首页</figcaption></figure>
</div>
</article>
</div>
<div class="deploy-faq">
<h3>常见问题</h3>
<details><summary>提示“令牌无效或已过期”</summary><p>部署命令有效期 30 分钟。回到「一键部署」重新生成即可;源码包更新后旧命令也会自动失效,防止装到不一致的版本。</p></details>
<details><summary>提示“未找到 PHP CLI”</summary><p>在宝塔面板安装 PHP 8.1 / 8.2,并确认终端执行 <code>php -v</code> 正常;也可以设置 <code>KM_PHP_BIN=/www/server/php/82/bin/php</code> 指定路径。</p></details>
<details><summary>提示 curl 或解压失败</summary><p>安装 <code>curl</code> 与 <code>unzip</code>:CentOS 用 <code>yum install -y curl unzip</code>,Ubuntu / Debian 用 <code>apt install -y curl unzip</code>。</p></details>
<details><summary>data / storage 目录不可写</summary><p>在宝塔面板把这些目录归属设为 <code>www</code>,权限 755;脚本默认会尝试自动处理,找不到 Web 用户时会给出提示。</p></details>
<details><summary>为什么不用在宝塔里创建数据库</summary><p>SQLite 不需要数据库服务,整个数据库就是站点目录里的 <code>data/komorebi.sqlite</code> 文件。安装时数据库类型手动输入 <code>sqlite</code> 即可;备份时连同这个文件一起复制。</p></details>
<details><summary>访问首页空白或 500</summary><p>先确认站点 PHP 版本是 8.1 / 8.2,再查看 <code>data/php-error.log</code>。如果开了 CDN 或缓存插件,先刷新缓存;仍无法访问时,把 <code>data</code>、<code>storage</code>、<code>uploads</code> 所有者改为 <code>www</code>、权限 755。</p></details>
<details><summary>已有站点会被覆盖数据吗</summary><p>不会。完整源码包不包含数据库配置、上传文件和运行数据;脚本只更新程序源码,并在更新前备份旧核心文件。</p></details>
</div>
</div>
</section>
<section class="panel deploy-panel">
<h2 class="section-title">执行流程</h2>
<ol class="deploy-steps">
<li><strong>下载</strong>:从本站源码下载中心拉取冻结发布包,不走第三方网盘。</li>
<li><strong>校验</strong>:比对 SHA256,文件不完整或被篡改会立即停止。</li>
<li><strong>备份</strong>:目标目录已有站点时,旧核心源码备份到 <code>data/deploy-backup/</code>,并保留 <code>config.php</code>、上传文件和运行数据。</li>
<li><strong>安装</strong>:新服务器自动建库、建表、创建管理员并生成 <code>config.php</code>;已有站点只更新源码。</li>
<li><strong>收尾</strong>:修正 data / storage / uploads 权限,清理缓存,输出访问地址。</li>
</ol>
<p class="muted">需要服务器已安装 PHP 7.4 以上(建议 8.1 / 8.2)、curl,以及 unzip 或 python3 之一;宝塔面板默认满足。</p>
</section>
<script>
(function () {
var btn = document.getElementById('deployCopy');
if (!btn) return;
btn.addEventListener('click', function () {
var el = document.getElementById(btn.getAttribute('data-copy-target'));
if (!el) return;
el.select();
el.setSelectionRange(0, 99999);
var done = function () {
var old = btn.textContent;
btn.textContent = '已复制';
setTimeout(function () { btn.textContent = old; }, 1600);
};
if (navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(el.value).then(done, function () { document.execCommand('copy'); done(); });
} else {
document.execCommand('copy');
done();
}
});
})();
</script>
<script>
(function () {
var tabs = document.querySelectorAll('[data-deploy-tab]');
var panes = { video: document.getElementById('deployTabVideo'), guide: document.getElementById('deployTabGuide') };
tabs.forEach(function (tab) {
tab.addEventListener('click', function () {
var name = tab.getAttribute('data-deploy-tab');
tabs.forEach(function (t) {
var on = t === tab;
t.classList.toggle('is-on', on);
t.setAttribute('aria-selected', on ? 'true' : 'false');
});
Object.keys(panes).forEach(function (k) { if (panes[k]) panes[k].hidden = (k !== name); });
var v = panes.video && panes.video.querySelector('video');
if (name !== 'video' && v && !v.paused) v.pause();
});
});
})();
</script>
<?php render_footer(); ?>