如何安装Graphite Editor

🔧 一、环境准备（全平台通用）

1. 基础依赖
   • Rust编译环境：安装最新稳定版Rust（≥1.65）
     1. curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
     2. source "$HOME/.cargo/env"
   • Node.js运行时：需LTS版本（≥18.x）
     1. # Ubuntu示例
     2. curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
     3. sudo apt-get install -y nodejs
2. 项目依赖库
   • Linux/macOS：build-essential（GCC套件）、pkg-config、libssl-dev
     1. sudo apt install build-essential pkg-config libssl-dev # Ubuntu/Debian
   • Windows：安装 Visual Studio Build Tools 并勾选”C++桌面开发”

---

🚀 二、安装与本地启动

1. 克隆代码库
   1. git clone https://github.com/GraphiteEditor/Graphite.git
   2. cd Graphite
2. 安装依赖与编译
   • 后端Rust编译（耗时约5-15分钟）：
     1. cargo build --release # 生产环境用--release优化性能
   • 前端依赖安装：
     1. npm install
3. 启动网页端服务
   1. npm start # 默认监听 http://localhost:8080
   关键参数说明：
   • 修改端口：PORT=3000 npm start
   • 生产模式：NODE_ENV=production npm start

---

🌐 三、生产环境部署（Nginx反向代理）

1. 配置Nginx
   1. server {
   2. listen 80;
   3. server_name graphite.example.com;
   4. location / {
   5. proxy_pass http://localhost:8080; # 指向本地服务端口
   6. proxy_http_version 1.1;
   7. proxy_set_header Upgrade $http_upgrade;
   8. proxy_set_header Connection 'upgrade';
   9. proxy_set_header Host $host;
   10. proxy_cache_bypass $http_upgrade;
   11. }
   12. # 启用HTTPS（需提前部署证书）
   13. listen 443 ssl;
   14. ssl_certificate /path/to/cert.pem;
   15. ssl_certificate_key /path/to/privkey.pem;
   16. }
   重启Nginx：sudo systemctl restart nginx
2. 防火墙配置
   1. sudo ufw allow 80/tcp # HTTP
   2. sudo ufw allow 443/tcp # HTTPS
   3. sudo ufw allow 8080/tcp # Graphite服务端口

---

⚠️ 四、常见问题解决

问题现象	解决方案
Rust编译失败	更新工具链：rustup update 并检查libssl-dev是否安装
npm install卡住	切换国内源：npm config set registry https://registry.npmmirror.com
页面加载空白	清理缓存：npm run clean && npm start
端口冲突	修改端口：编辑package.json中start脚本的端口参数
生产环境静态资源404	检查Nginx配置中proxy_pass路径，确保包含/结尾

---

💎 五、高级功能扩展

1. Docker容器化部署
   1. FROM node:18-alpine AS frontend
   2. WORKDIR /app
   3. COPY . .
   4. RUN npm install && npm run build
   6. FROM rust:1.65 AS backend
   7. WORKDIR /usr/src/graphite
   8. COPY . .
   9. RUN cargo build --release
   11. # 运行阶段镜像（示例）
   12. CMD ["npm", "start"]
2. 云服务集成
   • AWS/Azure：使用EC2/VM部署，绑定弹性IP
   • Kubernetes：通过Helm Chart自动化部署

---

主编写在最后：Graphite Editor通过Rust+Web技术栈实现了高性能图形编辑能力，其网页端服务部署需重点关注编译环境一致性与生产环境网络隔离。建议首次部署后运行官方示例测试渲染功能：

cargo test --package graphite-core --test rendering