笔记
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)。
这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。
不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。
产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。
趋势
nginx 反代 websocket 老断连/502:只加 Upgrade 头不够,超时和缓冲也要配
用 nginx 反代一个带 WebSocket 的服务(比如实时日志、在线终端、Web IDE),浏览器连上一会儿就断,或者频繁 502。很多教程只说"加 Upgrade 头",但实际光加 Upgrade 只解决"能不能升级成 WebSocket",连接稳定性和超时是另一组配置。
先说最基础的——没有 Upgrade/Connection 头,nginx 不会把连接升级成 WebSocket:
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
这个不加,WebSocket 根本握手不过去。但加了之后还是老断,往下查:
1. 代理超时太短。 WebSocket 是长连接,可能长时间没消息。nginx 的 proxy_read_timeout 默认 60 秒,如果在这期间后端没数据(比如心跳间隔 >60s),nginx 就断开连接。这是"用着用着断"的最常见原因:
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
调长后,只要客户端和后端有任意一方发心跳/数据就不会被掐。注意:如果后端本身有心跳,60s 默认通常够;是后端没有心跳才会撞这个超时。
2. 缓冲导致"半截"或延迟。 nginx 反代默认会缓冲后端响应。对 WebSocket 本身影响小,但对**SSE(Server-Sent Events)**或流式输出影响极大——后端逐条推数据,nginx 攒着缓冲不吐,前端看到的就是"迟迟没反应"或"一次性全来"。关掉缓冲:
proxy_buffering off;
3. 没开 keepalive 到后端 / 连接数限制。 WebSocket 一个客户端一条长连接,前端并发多时 nginx 到后端的连接池要够,upstream 配 keepalive:
upstream ws_backend {
server 127.0.0.1:9000;
keepalive 32; # 到后端的空闲连接池
}
4. 负载均衡下 WebSocket 会话绑定。 如果有多个后端实例,WebSocket 是长连接,必须保证同一个客户端始终连到同一台后端(session 粘滞),否则刷新/重连可能落到另一台,会话状态丢了表现成"莫名其妙断开":
upstream ws_backend {
ip_hash; # 按 IP 哈希,保证同一客户端固定一台
server 127.0.0.1:9000;
server 127.0.0.1:9001;
}
5. 后端进程数/文件句柄。 WebSocket 长连接占 fd,后端单进程能扛的连接有限,连接一多就被拒,表现成间歇 502。看后端日志和 ss -tnp | grep 连接数。
完整参考配置:
location /ws/ {
proxy_pass http://ws_backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_buffering off;
}
排查顺序: 握手都不行 → 补 Upgrade/Connection 头;连上就断 → 看是不是超时没心跳;流式数据卡 → 关 proxy_buffering;多后端断 → ip_hash 粘滞 + keepalive;间歇 502 → 查后端连接上限。按现象对症,别只记 Upgrade 一个点。