{"id":13523217,"url":"https://github.com/linfaxin/MBBS","last_synced_at":"2025-04-01T00:31:04.363Z","repository":{"id":45846052,"uuid":"513443050","full_name":"linfaxin/MBBS","owner":"linfaxin","description":"🔥轻量级全功能论坛、移动/PC双端适配、无依赖一键启动、技术栈 express + sqlite + react（MBBS论坛托管服务开源版）","archived":false,"fork":false,"pushed_at":"2024-08-11T06:52:33.000Z","size":988,"stargazers_count":165,"open_issues_count":1,"forks_count":22,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-26T07:08:34.353Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://mbbs.cc","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linfaxin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-13T08:37:04.000Z","updated_at":"2025-03-06T07:07:17.000Z","dependencies_parsed_at":"2023-02-09T15:31:18.357Z","dependency_job_id":"44d7bd46-71a4-41d7-a30c-7f7e003e671b","html_url":"https://github.com/linfaxin/MBBS","commit_stats":{"total_commits":20,"total_committers":1,"mean_commits":20.0,"dds":0.0,"last_synced_commit":"2f3495c37015f04461063085b443f445c399434b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linfaxin%2FMBBS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linfaxin%2FMBBS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linfaxin%2FMBBS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linfaxin%2FMBBS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linfaxin","download_url":"https://codeload.github.com/linfaxin/MBBS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246563320,"owners_count":20797441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T06:00:57.249Z","updated_at":"2025-04-01T00:31:03.541Z","avatar_url":"https://github.com/linfaxin.png","language":"TypeScript","funding_links":[],"categories":["Forum"],"sub_categories":[],"readme":"[![npm version](https://badgen.net/npm/v/mbbs)](https://www.npmjs.com/package/mbbs)\n[![MIT License](https://img.shields.io/npm/l/mbbs.svg?sanitize=true)](https://www.npmjs.com/package/mbbs)\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/linfaxin/mbbs\"\u003e\n    \u003cimg src=\"http://mbbs.cc/images/default-logo.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eMBBS 开源版\u003c/h3\u003e\n  \u003cp align=\"center\"\u003e\n    🔥轻量级全功能论坛\n    \u003cbr /\u003e\n    \u003ca href=\"http://mbbs.cc/\"\u003e官网\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/linfaxin/mbbs/issues\"\u003e提Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"#特性\"\u003e特性\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 预览\n\n![preview-image](http://mbbs.cc/images/demo_preview.png)\n\n## 一键安装启动\n\n无需繁琐的安装配置，一键安装并启动论坛，[查看更多启动参数](#更多启动参数)\n\n安装：\n\n```shell\nnpm i -g mbbs --registry=https://registry.npmmirror.com # 全局安装 mbbs 模块\n# 使用的部分依赖库（sqlite3、bcrypt）在安装时会从 github 下载 prebuild 文件\n# 可能会由于国内网络问题，在快结束时卡住，请耐心等待，如果失败请重试\n```\n\n启动：\n\n```shell\ncd ./要部署论坛的目录\nmbbs serve # 在当前目录启动论坛服务（首次创建会提示输入管理密码）\n```\n\n\u003e 如果提示 npm 命令找不到，需要先安装 [Node.js](https://nodejs.org/) 最新版本\n\n## 特性\n\n- 无依赖一键部署启动\n- 移动/PC 双端兼容\n- Material Design 视觉风格\n- 可视化后台管理\n- 全功能论坛：版块/楼中楼/角色权限/审核/富文本编辑/个性化配置/邮件通知 等\n- 自带授权登录：免开发支持 QQ/微信/支付宝 授权登录\n\n## 更多启动参数\n\n命令行启动论坛时，可以用 `mbbs serve --参数名1 参数值1 --参数名2 参数值2` 的形式指定更多可选参数\n\n- --db: 指定论坛的数据库文件名，默认为 `bbs`，启动后会在当前目录创建/使用 `\u003c参数值\u003e.db` Sqlite 数据库文件\n- --res-dir: 指定 上传图片/视频/附件 的本地储存目录，默认为 `./resources`\n- --port: 指定论坛启动在本机的端口，默认为 `884`\n- --set-admin-password: 使用这个参数在启动论坛时，重置管理员密码为参数值\n\n## 论坛托管服务\n\n你还可以选择使用 [MBBS 论坛托管服务](http://mbbs.cc) 一键创建并托管你的论坛，免去购买 服务器/域名/安装 等步骤。\n\n托管后，如果想转为私有服务器部署，可以直接在托管后台导出论坛数据，使用开源版本 MBBS 私有化部署。\n\n## 定制开发论坛\n\n如果论坛当前能力/特性不能满足你的诉求，你可以直接 修改定制开源版本：\n\n- git clone 至本地并 cd 进目录\n- 开发调试：`npm run dev`\n- 正式运行：`npm run start`\n\n#### 技术栈\n\n- 后端：Node.js ([express](https://github.com/expressjs/express) + [routing-controllers](https://github.com/typestack/routing-controllers.git) + Typescript)\n- 前端：React ([mui](https://mui.com/) + Typescript)\n- 数据库：Sqlite (ORM: [sequelize](https://sequelize.org/))\n\n开发过程中如果什么问题，也可以 [在此交流](http://bbs.mbbs.cc/#/thread/category/5)\n\n## Star \u0026 PR\n\n喜欢的朋友帮忙给个 Start，欢迎提 PR！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinfaxin%2FMBBS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinfaxin%2FMBBS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinfaxin%2FMBBS/lists"}