墨穗app.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v1.0.165 · 墨穗笔记
笔记

Notebase墨穗
静水流深,落墨成穗。

0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →

笔记

0
加载中...

工具

0

此页用于记录用户反馈问题后的每一次改进

关于

笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

不想公开、只想临时给人看:点“分享”生成一条带密码和有效期的链接,到期自动失效,你也能随时撤销。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势

// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

history 路由一刷新就 404,nginx 补个 try_files 兜底

2026-09-02技术教程

把 vue/react 打包出来的 dist 扔到 nginx 上,首页能开,页面里点链接跳转也正常,可一旦按 F5 刷新,或者直接在地址栏敲 /user/123 这种二级路由进去,就白屏报 404。翻 nginx 错误日志,全是 open() "/var/www/app/dist/user/123" failed 这种,纠结半天才反应过来:SPA 只有一个真实入口 index.html,所谓路由都是 history 模式在前端 JS 里模拟的。浏览器把 /user/123 当成真实路径发给服务器,nginx 去磁盘找 user/123 这个文件,找不到就回 404,整个过程后端根本没参与。

hash 模式(url 里带 #/user/123)不会有这个毛病,因为 # 后面那段不会发给服务器,所以很多项目第一版用 hash 一直没事,一换 history 就炸,属于典型的上线前没测深层路由。

解法是在 nginx 里加 try_files,让它在磁盘上匹配不到真实文件时一律回退到 index.html,把路由判断交回给前端 JS:

server {
    listen 80;
    server_name _;
    root /var/www/app/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

$uri 先找真实文件,$uri/ 再试目录(目录存在会触发 index 找 index.html),两个都不行就内部 rewrite 到 /index.html。这一个配置基本就把刷新 404 解决了。

配完有几个容易连环踩的坑,漏一个就在别处炸:

root 目录要指对。有人把 root 写到 location 里、或者 dist 解压错层级,症状是刷新 404 和静态资源 404 混着来。先 curl 一个真实存在的文件确认 root 指对了,再谈 fallback。

接口请求会被 try_files 抢走。接口和页面共用同一个 server 时,location / 的 try_files 是兜底的,/api/login 这种请求在磁盘上找不到文件,会被静默 rewrite 回 index.html,返回给你的是一坨 200 的 HTML 而不是接口 JSON,前端 axios 拿 HTML 去 JSON.parse,报各种莫名其妙的解析错误。正确做法是给接口单独开 location,前缀更具体会优先命中:

location /api/ {
    proxy_pass $scheme://127.0.0.1:3000;
}

location / {
    try_files $uri $uri/ /index.html;
}

nginx 匹配 location 是前缀最长优先,/api/ 这个 location 更具体,请求先进它,不会掉进 / 的 try_files。静态资源目录同理,/assets/、/uploads/ 这类最好都显式写出来,或者用 ^~ 精确掐断,免得被 fallback 吞掉。

部署在子路径下的更麻烦。vite 配了 base: '/admin/',路由是 /admin/user,这时候 fallback 得写成 /admin/index.html,否则刷新时 nginx 把请求 rewrite 回根 /index.html,而页面里引的资源全是 /admin/assets/xxx,root 下要是没有 /admin 这个目录就全挂。三个地方必须对齐:路由 base、资源 publicPath、nginx 的 try_files 目标,少一个就 404 得莫名其妙。

开发环境永远不会遇到这问题,vite/webpack 的 dev server 内置了 historyApiFallback,任何路径都返回 index.html。所以本地联调好好的,一部署就深层路由 404,第一反应就该往 nginx 这想。我这次是先看 error.log 发现请求真打到 /user/123 这个文件路径上,才确定是服务端没兜底,这个定位顺序比瞎改前端快得多。

验证别只点首页链接,直接 curl 一个深层路径看返回:

curl -sI 127.0.0.1/user/123 | head -1

返回 200 基本就成了。我习惯再补一条 curl 检查 /api/ 的路径返回的是 JSON 而不是 HTML,防止 try_files 把接口也兜走了。

相似推荐
局域网打印机共享和扫描到文件夹:USB 一体机连一台 Linux 小主机当打印服务器退役笔记本改常开服务器,先解决功耗和合盖睡眠N1 盒子刷 Armbian 后在 Docker 里跑 OpenWrt 当旁路由:macvlan 全流程踩坑记录把电脑上一个文件夹变成网站给别人访问:nginx 静态站点配置一次写对NETGEAR R7900 刷第三方固件变砖,只亮电源红灯和 LAN 灯?官方 NMRP 工具能救重装 Windows 后 grub 不见了、开机直接进 Windows?Boot-Repair 完还得 bcdedit 拉一把
编写使用方法
Markdown 格式 · Ctrl+Enter 确定
0 字新建笔记
欢迎回来
登录你的墨穗笔记账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属墨穗笔记
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

隐私提醒

取消
编辑工具
受控分享
为这篇笔记生成限时 / 带密码的临时链接
关闭