Applies to: Dịch vụ lưu trữ GoDaddy Node.js

Dịch vụ lưu trữ GoDaddy Node.js Trợ giúp

Chúng tôi đã cố hết sức để dịch trang này cho bạn. Trang Tiếng Anh cũng có khả dụng.

Tải ứng dụng do AI tạo của tôi lên GoDaddy Node.js Hosting

Tải lên và triển khai ứng dụng do AI tạo của bạn lên GoDaddy Node.js Hosting bằng một tập tin zip.

Lưu ý: Bạn thích sử dụng GitHub? Xem các bài viết triển khai của chúng tôi cho các ứng dụng Cusor và Claude hoặc Loveable .
  1. Nếu bạn chưa có, hãy truy cập đại lý mã hóa AI của bạn (Con trỏ, Replit, Claude hoặc những người khác) và tạo ứng dụng của bạn.
  2. Truy cập đại lý mã hóa AI của bạn (Con trỏ, Replit, Claude hoặc các ứng dụng khác) và nhập lời nhắc bên dưới cho ứng dụng của bạn. Thao tác này sẽ cập nhật ứng dụng của bạn để đáp ứng tốt hơn các yêu cầu của GoDaddy Node.js Hosting.
    Tôi cần bạn điều chỉnh dự án Node.js của tôi để có thể triển khai dự án trên nền tảng lưu trữ có các yêu cầu sau. Xem qua mọi yêu cầu, kiểm tra xem dự án của tôi đã đáp ứng yêu cầu chưa và thực hiện những thay đổi tối thiểu cần thiết để dự án thực hiện được. KHÔNG loại bỏ bất kỳ chức năng hiện có nào. ## Yêu cầu ### 1. package.json Thư mục gốc của dự án phải chứa một `package.json` hợp lệ với ít nhất các trường sau: -` "name" `- tên ứng dụng -` "phiên bản" `- một semver chuỗi phiên bản (ví dụ: "1.0.0") - `" main "` - tập tin điểm nhập (ví dụ "server.js" hoặc "index.js") ### 2. Xây dựng & khởi động tập lệnh `package.json` phải xác định các tập lệnh npm này: - `" dựng "` - biên dịch / đóng gói ứng dụng (có thể là no-op như `" echo build "` nếu không có gì cần biên dịch) - `" start "` - khởi động máy chủ sản xuất (vd: `" node server.js "`) ### 3. Liên kết cổng Ứng dụng phải lắng nghe cổng được cung cấp bởi biến môi trường `PORT` thay vì một cổng mã hóa cứng. Ví dụ: `` `js const port = process.env.PORT || 3000; app.listen (cổng); `` `### 4. Sự phụ thuộc Tất cả các phần phụ thuộc trong thời gian chạy phải được liệt kê trong phần` phụ thuộc` trong `package.json`. Thư mục `node_modules` KHÔNG được đưa vào tải lên - nền tảng sẽ tự động chạy` npm install`. ### 5. Biến môi trường Mọi bí mật, khóa API hoặc URL bên ngoài phải được đọc từ `process.env.VARIABLE_NAME`. Không mã hóa cứng các giá trị nhạy cảm. ### 6. Ứng dụng Vite (nếu có) Nếu dự án sử dụng Vite, nền tảng sẽ tự động cập nhật cấu hình máy chủ lưu trữ được phép. Không cần thay đổi thủ công cho Vite, nhưng hãy đảm bảo máy chủ phát triển và máy chủ xem trước vẫn tôn trọng `process.env.PORT`. ### 7. Giới hạn kích thước tập tin Tập tin zip thu được phải dưới 100 MB. Đảm bảo rằng `node_modules`, bộ nhớ đệm dựng và các thư mục được tạo lớn khác bị loại trừ. ## Việc cần làm 1. Đánh giá dự án theo mọi yêu cầu ở trên. 2. Áp dụng những thay đổi nhỏ nhất giúp dự án tuân thủ. 3. Liệt kê mọi thay đổi bạn đã thực hiện và lý do.
  3. Nếu bạn định có các bản cập nhật liên tục, hãy tải xuống CLAUDE.md và tải lên tập tin trong thư mục gốc của kho ứng dụng của bạn.
    # CLAUDE.md - Dịch vụ lưu trữ Node.js Dự án này được xây dựng để triển khai trên Dịch vụ lưu trữ Node.js, một nền tảng lưu trữ Node.js được quản lý. Sử dụng tập tin này làm ngữ cảnh khi giúp xây dựng, sửa lỗi hoặc chuẩn bị triển khai ứng dụng này. ## Tổng quan về nền tảng Dịch vụ lưu trữ Node.js là một PaaS được quản lý của Node.js hỗ trợ các ứng dụng Node.js và các trang tĩnh. Khách hàng tải lên thư mục dự án của họ thông qua giao diện GoDaddy - không có Docker, không có đường ống CI / CD, không cần cấu hình cơ sở hạ tầng. Nền tảng xử lý SSL, CDN và tính toán phía máy chủ tự động. ## Luồng triển khai 1. Khách hàng tải lên thư mục dự án của họ thông qua Giao diện người dùng lưu trữ Node.js 2. Nền tảng này sẽ cài đặt các phần phụ thuộc và xây dựng ứng dụng 3. Ứng dụng được triển khai tới môi trường xem trước riêng tư (yêu cầu GoDaddy auth để xem) 4. Khi đã sẵn sàng , khách hàng có thể xuất bản lên sản xuất và kết nối một miền tùy chỉnh ## Yêu cầu ### package.json Mọi dự án phải có một `package.json` hợp lệ trong thư mục gốc với một tập lệnh` start`. Đây là cách nền tảng biết cách chạy ứng dụng. `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependencies ": {" express " : "^ 4.18.0"}} `` `Nền tảng chạy` npm install` theo sau bởi `npm start` để khởi động ứng dụng. ### Điểm vào Ứng dụng cần một điểm vào rõ ràng được tham chiếu bởi tập lệnh `start`. Các mẫu phổ biến: - `node server.js` -` node index.js` - `node app.js` -` next start` (đối với các ứng dụng Next.js) ### Port Binding Ứng dụng phải lắng nghe trên cổng được cung cấp bởi biến môi trường `PORT`. Không mã hóa cứng một cổng. `` `javascript const port = process.env.PORT || 3000; app.listen (port, () = > {console.log (\ `Máy chủ chạy trên cổng \ ${port} \ `); }); `` `### Trang tĩnh Đối với các trang tĩnh không có logic phía máy chủ, hãy bao gồm một máy chủ đơn giản phục vụ các tập tin tĩnh:` `` javascript const express = Request ('express'); const path = Request ('đường dẫn'); const app = express (); const port = process.env.PORT || 3000; app.use (express.static (path.join (__ dirname, 'public'))); app.get ('*', (req, res) = > {res.sendFile (path.join (__ dirname, 'public', 'index.html'));}); app.listen (cổng); Lưu trữ Node.js Frameworks được hỗ trợ bất kỳ ứng dụng Node.js nào có thể chạy qua `npm start`. Điều này bao gồm nhưng không giới hạn ở: - Express.js - Next.js - Fastify - Nuxt.js - Remix - Nest.js - Hono - Koa - Các trang tĩnh được phân phối qua máy chủ Node.js Nếu khung công tác của bạn tạo bản dựng sản xuất và có thể bắt đầu thông qua một tập lệnh `" start "`, nó sẽ hoạt động trên Node.js Hosting. ## Đơn mỗi lần tải lên Dịch vụ lưu trữ Node.js dự kiến sẽ có một ứng dụng cho mỗi lần tải lên. Các bản đơn âm và cài đặt đa ứng dụng không được hỗ trợ trừ khi một lệnh `npm start` duy nhất ở gốc khởi động mọi thứ mà ứng dụng cần. Nếu dự án của bạn là một monorepo, hãy trích xuất ứng dụng cụ thể mà bạn muốn triển khai vào thư mục riêng với `package.json` của chính nó và thay vào đó tải lên thư mục đó. Ví dụ: nếu repo của bạn có cấu trúc như `các gói / api` và` các gói / web`, chỉ tải lên `các gói / web` dưới dạng một dự án độc lập với tập lệnh` package.json` và `start` hoàn chỉnh của riêng nó. ## Cấu trúc dự án Nền tảng linh hoạt với cấu trúc. Miễn là gốc chứa một `package.json` hợp lệ với một tập lệnh` start`, ứng dụng sẽ được triển khai. Một cấu trúc điển hình trông giống như: `` my-app / ├── package.json # Bắt buộc - phải bao gồm tập lệnh "bắt đầu" ├── server.js # Entry point (hoặc index.js, app.js, v.v.) ├── public / # Tài sản tĩnh (nếu có) │ ├── index.html │ ├── styles.css │ └── script.js ├── route / # API route (nếu có) ├── lượt xem / # Mẫu (nếu có) ├── .env.example # Yêu cầu tài liệu env vars (không tải lên .env) └── CLAUDE.md # Tập tin này `` `## Biến môi trường -` PORT` được cung cấp tự động bởi nền tảng. Luôn sử dụng `process.env.PORT`. - Mọi biến số môi trường bổ sung mà ứng dụng cần có thể được cấu hình thông qua Giao diện người dùng lưu trữ Node.js sau khi tải lên. - Không bao giờ xác nhận bí mật hoặc tập tin `.env` trong thư mục tải lên. ## Những gì nền tảng xử lý Bạn không cần phải cấu hình hoặc lo lắng về: - Chứng nhận SSL / TLS - được cung cấp tự động - CDN - bao gồm ngoài hộp - Quản lý quy trình - nền tảng quản lý việc khởi động lại và thời gian hoạt động - Cơ sở hạ tầng máy chủ - máy tính được quản lý hoàn toàn # # Triển khai từ các tác nhân Mã hóa AI Nhiều khách hàng xây dựng ứng dụng của họ bằng các tác nhân hỗ trợ AI như Replit, Lovable, Bolt, Cursor hoặc Claude. Các ứng dụng này có thể được triển khai trên Dịch vụ lưu trữ Node.js, nhưng thường cần những điều chỉnh nhỏ trước khi chúng sẵn sàng. ### Cách tải mã của bạn vào Dịch vụ lưu trữ Node.js 1. Xuất hoặc tải xuống dự án của bạn dưới dạng zip từ tác nhân AI 2. Giải nén thư mục trên máy tính 3. Kiểm tra và khắc phục các sự cố thường gặp bên dưới 4. Tải lên thư mục thông qua Node .js Giao diện người dùng lưu trữ ### Các sự cố thường gặp và cách khắc phục ** Thiếu hoặc không đầy đủ `package.json` ** Một số tác nhân AI không tạo ra một` gói.json` hoàn chỉnh. Đảm bảo rằng của bạn tồn tại trong thư mục gốc và bao gồm một tập lệnh `" bắt đầu "`. Nếu thiếu, hãy tạo một tệp: `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," phụ thuộc ":{} } `` `Sau đó chạy cục bộ` npm install` để tạo các phần phụ thuộc chính xác. ** Các cổng được mã hóa cứng ** Tác nhân AI thường mã hóa cứng một cổng như `3000` hoặc` 8080`. Thay thế bất kỳ cổng mã cứng nào bằng `process.env.PORT`:` `` javascript // Trước (phổ biến trong mã do AI tạo) app.listen (3000); // Sau khi (sẵn sàng cho Dịch vụ lưu trữ Node.js) app.listen (process.env.PORT || 3000); `` `** Sự phụ thuộc không đúng chỗ ** Các tác nhân AI đôi khi đặt phần phụ thuộc sản xuất dưới` "devDependencies" `. Di chuyển bất cứ thứ gì ứng dụng cần trong thời gian chạy vào `" phần phụ thuộc "`. ** Thiếu điểm nhập ** Đảm bảo rằng tập tin được tham chiếu trong tập lệnh `" bắt đầu "` của bạn thực sự tồn tại. Các tác nhân AI đôi khi tạo ra một `main.js` nhưng tập lệnh bắt đầu lại trỏ đến` index.js` hoặc ngược lại. ** Các tập tin dành riêng cho Replit ** Các dự án Replit thường bao gồm các tập tin cấu hình `.replit` và` replit.nix`. Những thứ này không cần thiết và có thể được gỡ bỏ trước khi tải lên. Tập trung vào việc có một `package.json` sạch sẽ với tập lệnh` "start" `chính xác. ** Xuất tình yêu / Bolt ** Các tác nhân này thường xuất các ứng dụng chỉ giao diện người dùng mà không có máy chủ. Nếu quá trình xuất của bạn không bao gồm một tập tin máy chủ, hãy thêm một tập tin đơn giản để cung cấp các tập tin tĩnh của bạn: `` javascript const express = Request ('express'); const path = Request ('đường dẫn'); const app = express (); const port = process.env.PORT || 3000; app.use (express.static (path.join (__ dirname, 'dist'))); app.get ('*', (req, res) = > {res.sendFile (path.join (__ dirname, 'dist', 'index.html'));}); app.listen (cổng); `` `Hãy đảm bảo thêm` express` vào phần phụ thuộc của bạn: `npm install express --save` ### Xác thực nhanh Trước khi tải lên, hãy chạy nội dung này để xác nhận mọi thứ hoạt động:` `bash npm install npm start` `` Nếu ứng dụng của bạn khởi động và có thể truy cập được tại `http://localhost:3000 `(hoặc bất cứ cổng nào), nó đã sẵn sàng cho Dịch vụ lưu trữ Node.js. ## Ví dụ về cài đặt khung ### Express.js Đảm bảo `express` nằm trong` phụ thuộc` (không phải `devDependencies`) và tập lệnh` start` trỏ đến tập tin máy chủ của bạn. ### Next.js Sử dụng `bản dựng tiếp theo` làm tập lệnh` bản dựng` và `bắt đầu tiếp theo` làm tập lệnh` bắt đầu`: `` `json {" scripts ": {" bản dựng ":" bản dựng tiếp theo "," bắt đầu ":" next start "}}` `Các ứng dụng Next.js hoạt động hiệu quả với kết xuất phía máy chủ, các tuyến API và tạo tĩnh. ### Nuxt.js Tương tự như Next.js - dựng rồi bắt đầu: `` `json {" scripts ": {" build ":" nuxt build "," start ":" node .output / server / index.mjs " }} `` `### Phối lại` `` json {"scripts": {"build": "remix build", "start": "remix-serve build"}} `` `### Fastify Tương tự như Express - liên kết với `process.env.PORT` và sử dụng` 0.0.0.0` làm máy chủ lưu trữ: `` `javascript fastify.listen ({port: process.env.PORT || 3000, host: '0.0.0.0'} ); `` `### Nest.js` `` json {"scripts": {"build": "nest build", "start": "node dist / main"}} `` `## Danh sách kiểm tra trước khi tải lên tải lên Dịch vụ lưu trữ Node.js, xác minh: - [] `package.json` tồn tại trong thư mục gốc - []` package.json` có tập lệnh `" bắt đầu "` - [] Tất cả các sản phẩm phụ thuộc đều nằm trong `" phụ thuộc " `(không phải` "devDependencies" `) - [] Ứng dụng sẽ lắng nghe trên` process.env.PORT` - [] Không có cổng, đường dẫn tập tin bí mật hoặc cục bộ được mã hóa cứng - [] Ứng dụng chạy cục bộ với `npm install && npm start` - [] Nếu sử dụng một bước dựng, tập lệnh `" dựng "` được định nghĩa trong `gói.json` ## Khắc phục sự cố ### Ứng dụng sẽ không khởi động - Kiểm tra xem có tồn tại tập lệnh` "bắt đầu" `trong` gói.json` - Đảm bảo rằng tập tin điểm nhập được tham chiếu trong `" start "` thực sự tồn tại - Xác minh tất cả các phần phụ thuộc được liệt kê trong `" phần phụ thuộc "` ### Lỗi cổng - Không bao giờ viết cứng số cổng - luôn sử dụng `process.env.PORT` - Đối với các khung công tác cần máy chủ lưu trữ, liên kết với `0.0.0.0` không phải` localhost` ### Thiếu mô-đun - Đảm bảo tất cả các gói bắt buộc đều nằm trong `" phụ thuộc "`, không phải `" devDependencies "` - Nền tảng chạy `npm install --production` để các phụ thuộc dev không được cài đặt ### Không cài đặt được ứng dụng - Nếu ứng dụng cần một bước xây dựng (TypeScript, Next.js, v.v. .), thêm tập lệnh `" dựng "` - Kiểm tra xem các đường dẫn đầu ra của bản dựng có khớp với những gì mà tập lệnh `" bắt đầu "` mong đợi hay không ## Nhận trợ giúp Nếu bạn gặp sự cố khi triển khai, hãy liên hệ qua giao diện Dịch vụ lưu trữ Node.js hoặc liên hệ với GoDaddy hỗ trợ.
  4. Tải ứng dụng của bạn từ đại lý mã hóa AI về máy tính của bạn.
  5. Zip các tập tin ứng dụng của bạn trên máy tính Windows hoặc Mac .
  6. Truy cập GoDaddy Node.js Hosting , chọn Tải lên ZIP , chọn Duyệt tập tin , tải lên tập tin zip của bạn, chọn Tôi không phải là người máy rồi chọn Triển khai .
  7. Chọn URL xem trước của bạn để xem ứng dụng của bạn trong trình duyệt.
  8. (Tùy chọn) Quản lý ứng dụng của bạn bằng cách chọn:
    • Tải lên mã mới : Thêm các tập tin mã khác
    • Cài đặt : Quản lý bí mật, thay đổi miền hoặc xóa ứng dụng của bạn
    • Khởi động lại ứng dụng xem trước : Khởi động lại bản xem trước của bạn.
    • Nhật ký thời gian chạy : Xem nhật ký ứng dụng của bạn.
    • Trình quản lý tập tin : Xem và chỉnh sửa các tập tin ứng dụng của bạn.
    • Cơ sở dữ liệu : Xem và chỉnh sửa cơ sở dữ liệu ứng dụng của bạn.
  9. (Tùy chọn) Nếu bạn cần các tập tin liên tục giữa các lần triển khai, hãy yêu cầu ứng dụng của bạn ghi các tập tin này vào thư mục công khai / tài sản.
  10. Khi bạn đã sẵn sàng phát trực tuyến, hãy chọn Xuất bản ngay .

Để quản lý các dự án của bạn, truy cập GoDaddy Node.js Hosting và ở phía trên bên phải, chọn Ứng dụng của tôi .

Xem thêm thông tin