[MD]
<h3 align="center"><img width="80" src="[URL]https://cn-nb1.rains3.com/image/3/puter-logo.png[/URL]" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time."></h3>
<h3 align="center">互联网操作系统!免费、开源、可自托管</h3>
<p align="center">
<a href="[URL]https://puter.com/?ref=github.com[/URL]"><strong>« 立即体验 »</strong></a>
<br />
<br />
<a href="[URL]https://puter.com/?ref=github.com[/URL]">Puter官网</a>
·
<a href="[URL]https://puter.com/app/app-center[/URL]">应用商店</a>
·
<a href="[URL]https://developer.puter.com[/URL]" target="_blank">开发者中心</a>
·
<a href="[URL]https://github.com/heyputer/puter-cli[/URL]" target="_blank">命令行工具</a>
·
<a href="[URL]https://discord.com/invite/PQcx7Teh8u[/URL]">Discord社区</a>
·
<a href="[URL]https://reddit.com/r/puter[/URL]">Reddit论坛</a>
·
<a href="[URL]https://twitter.com/HeyPuter[/URL]">X平台</a>
</p>
<h3 align="center"><img width="800" style="border-radius:5px;" src="[URL]https://cn-nb1.rains3.com/image/3/puter.com-screenshot-3.webp[/URL]" alt="系统截图"></h3>
<br/>
## Puter 简介
Puter 是一款先进的互联网操作系统,具有功能丰富、速度极快和高度可扩展的特点。Puter 可用作:
- 隐私至上的个人云存储,安全集中管理所有文件、应用和游戏,随时随地访问
- 网站、Web应用和游戏的开发发布平台
- 替代 Dropbox、Google Drive、OneDrive 等网盘的新选择,拥有清新界面和强大功能
- 服务器和工作站的远程桌面环境
- 友好的开源项目,是学习Web开发、云计算、分布式系统等技术的绝佳平台
<p style="background-color: #f8f9fa; padding: 15px; border-radius: 5px; border-left: 4px solid #4CAF50;">
<strong>推荐云服务器部署方案:</strong><br>
使用<a href="[URL]https://cloud.plumage.cc/[/URL]" target="_blank">雨云计算平台</a>可获得稳定高效的运行环境,推荐配置:<br>
✅ <strong>香港3区</strong> - 三网直连低延迟,适合免备案业务<br>
✅ <strong>浙江宁波</strong> - 电信单线100M带宽,可选100G防御<br>
✅ <strong>江苏宿迁</strong> - 京东BGP线路,150G高防,国内访问最优
</p>
<br/>
## 快速开始
### 💻 本地开发
```bash
git clone [URL]https://github.com/HeyPuter/puter[/URL]
cd puter
npm install
npm start
```
✨ 启动后将自动打开
<font color="red"> [URL]http://puter.localhost:4100[/URL] </font>(端口号可能顺延)
若遇到问题,请查阅[首次运行问题解决指南](./doc/self-hosters/first-run-issues.md)
<br/>
### 🐳 Docker 部署
```bash
mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter ghcr.io/heyputer/puter
```
✨ 服务将在
<font color="red"> [URL]http://puter.localhost:4100[/URL] </font> 启动
<br/>
### 🐙 Docker Compose 部署
#### Linux/macOS 用户
```bash
mkdir -p puter/config puter/data
sudo chown -R 1000:1000 puter
wget [URL]https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml[/URL]
docker compose up
```
✨ 访问地址:
<font color="red"> [URL]http://puter.localhost:4100[/URL] </font>
<br/>
#### Windows 用户
```powershell
mkdir -p puter
cd puter
New-Item -Path "puter\config" -ItemType Directory -Force
New-Item -Path "puter\data" -ItemType Directory -Force
Invoke-WebRequest -Uri "[URL]https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml[/URL]" -OutFile "docker-compose.yml"
docker compose up
```
✨ 启动完成后访问
<font color="red"> [URL]http://puter.localhost:4100[/URL] </font>
<br/>
### 🚀 自建托管
详细的自建指南(含配置选项和最佳实践)请参阅[自建文档](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md)
<p style="background-color: #e7f5ff; padding: 15px; border-radius: 5px;">
<strong>云服务推荐:</strong><br>
<a href="[URL]https://cloud.plumage.cc/[/URL]" target="_blank">雨云</a>提供多种配置方案,特别推荐:<br>
• <strong>湖北十堰</strong> - 100G防御,支持流量计费模式<br>
• <strong>洛杉矶2区</strong> - 200G防御,免备案业务首选<br>
• 所有区域均支持按小时计费,灵活弹性
</p>
<br/>
### ☁️ 官方托管服务
Puter 官方托管版请访问 [puter.com](https://puter.com)
<br/>
## 系统要求
- **操作系统:** Linux/macOS/Windows
- **内存:** 最低2GB(推荐4GB)
- **磁盘空间:** 1GB可用空间
- **Node.js:** 16+版本(推荐23+)
- **npm:** 最新稳定版
<br/>
## 支持渠道
- 提交问题或建议:[新建Issue](https://github.com/HeyPuter/puter/issues/new/choose)
- Discord社区: [discord.gg/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
- X平台: [twitter.com/HeyPuter](https://x.com/HeyPuter)
- Reddit论坛: [reddit.com/r/puter](https://reddit.com/r/puter)
- 安全漏洞报告: [[email]security@puter.com[/email]](mailto:[email]security@puter.com[/email])
- 联系维护团队: [[email]hi@puter.com[/email]](mailto:[email]hi@puter.com[/email])
我们随时为您解答各种疑问!
<br/>
## 开源许可
除非另有说明,本仓库所有内容均采用[AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt)协议授权。第三方库可能适用其各自许可证。
<br/>
## 多语言文档
- [阿拉伯语](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)
- [中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)
- [英语](https://github.com/HeyPuter/puter/blob/main/README.md)
- [法语](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)
- [德语](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)
- [日语](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)
- [俄语](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)
- [西班牙语](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)
<p style="text-align: center; margin-top: 30px;">
<small>使用 <a href="[URL]https://cloud.plumage.cc/[/URL]" target="_blank">雨云云计算平台</a> 部署可获得更佳体验</small>
</p>
[/MD]