Hướng dẫn deploy ASP.NET Core Web API lên hosting miễn phí MonsterASP.NET (2026)

C#Unity

Trong bài này
  1. Tổng quan quy trình
  2. Phần 1. Chuẩn bị project trước khi deploy
  3. 1.1. Công cụ cần có
  4. 1.2. Tạo project và cài package
  5. 1.3. Cấu trúc thư mục project mẫu
  6. 1.4. Ba điểm BẮT BUỘC trong Program.cs để chạy được trên host
  7. 1.5. Tạo Migration
  8. Phần 2. Đăng ký tài khoản MonsterASP.NET
  9. Bước 1. Truy cập trang chủ
  10. Bước 2. Điền form đăng ký
  11. Bước 3. Đăng nhập Control Panel
  12. Bước 4. Màn hình Dashboard
  13. Phần 3. Tạo website miễn phí
  14. Bước 5. Chọn gói FREE
  15. Bước 6. Đặt tên miền (subdomain)
  16. Bước 7. Chọn Datacenter
  17. Bước 8. Chọn ứng dụng mẫu
  18. Phần 4. Tạo database MSSQL miễn phí
  19. Bước 9. Chọn gói FREE cho Database
  20. Bước 10. Chọn loại Database
  21. Bước 11. Chọn Datacenter và tạo
  22. Bước 12. Lấy Connection String
  23. Phần 5. Đóng gói sản phẩm (publish)
  24. Bước 13. Publish bằng dòng lệnh
  25. Bước 14. Nén thành file .zip
  26. Phần 6. Upload và giải nén lên host
  27. Bước 15. Mở trang quản lý Website
  28. Bước 16. Vào thư mục wwwroot
  29. Bước 17. Upload file zip
  30. Bước 18. Giải nén (Unzip)
  31. Phần 7. Bật HTTPS (Let's Encrypt)
  32. Bước 19. Mở mục HTTPS
  33. Bước 20. Gói Free: gửi yêu cầu kích hoạt
  34. Bước 21. Điền và gửi ticket
  35. Phần 8. Kiểm tra API sau khi deploy
  36. 8.1. Kiểm tra nhanh
  37. 8.2. Test luồng trên Swagger
  38. 8.3. Kết quả kiểm tra thực tế trên bản demo
  39. Phần 9. Kết nối Unity tới API đã deploy
  40. Phần 10. Lỗi thường gặp và cách xử lý
  41. Checklist trước khi nộp bài

Bài này hướng dẫn từng bước đưa một ASP.NET Core Web API (EF Core + JWT + Swagger) lên hosting miễn phí của MonsterASP.NET: đăng ký tài khoản, tạo website *.runasp.net, tạo database MSSQL, đóng gói bằng dotnet publish, upload, bật HTTPS và gọi API từ Unity. Không cần thẻ tín dụng.

Tài liệu được soạn cho môn Lập trình Backend cho Game (Unity & C# .NET), đề thực hành giữa môn Player Save & Leaderboard System, nhưng các bước áp dụng cho mọi project ASP.NET Core 8/9.

Mục tiêu: Sau bài này, API của bạn chạy trên tên miền công khai dạng https://ten-cua-ban.runasp.net, có Swagger để giảng viên test trực tiếp và Unity gọi được API mà không cần localhost.

Tổng quan quy trình

  1. Chuẩn bị project ASP.NET Core Web API (EF Core + JWT + Swagger).
  2. Đăng ký / đăng nhập tài khoản MonsterASP.NET (miễn phí, không cần thẻ).
  3. Tạo Website miễn phí (subdomain *.runasp.net).
  4. Tạo Database MSSQL miễn phí, lấy Connection String.
  5. Đóng gói project bằng dotnet publish và nén thành file .zip.
  6. Upload file .zip lên thư mục wwwroot và giải nén (Unzip).
  7. Yêu cầu bật HTTPS (Let's Encrypt).
  8. Kiểm tra API qua Swagger / Postman và kết nối từ Unity.

Thông tin bản demo được thực hiện trong bài hướng dẫn này:

Hạng mụcGiá trị demo
Websiteplayersave-demo.runasp.net (site107840)
Swaggerhttp://playersave-demo.runasp.net/swagger
DatabaseMSSQL – db80020.databaseasp.net
FrameworkASP.NET Core 9 Web API, EF Core 9 (SqlServer), JWT Bearer, BCrypt, Swashbuckle

Phần 1. Chuẩn bị project trước khi deploy

1.1. Công cụ cần có

  • .NET SDK 8 hoặc 9 (kiểm tra bằng lệnh dotnet --list-sdks).
  • Visual Studio 2022 / VS Code / Rider.
  • Công cụ EF Core CLI: dotnet tool install --global dotnet-ef

1.2. Tạo project và cài package

dotnet new webapi -n PlayerSaveApi --use-controllers
cd PlayerSaveApi
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
dotnet add package BCrypt.Net-Next
dotnet add package Swashbuckle.AspNetCore --version 7.2.0

1.3. Cấu trúc thư mục project mẫu

PlayerSaveApi/
├── Controllers/
│   ├── AuthController.cs          POST /api/auth/register, /api/auth/login
│   ├── PlayerController.cs        GET /api/player/profile, PUT /api/player/save  [Authorize]
│   └── LeaderboardController.cs   GET /api/leaderboard?top=10
├── Data/AppDbContext.cs           DbContext + cấu hình quan hệ 1-1, Username unique
├── Models/User.cs, PlayerProfile.cs
├── Dtos/Dtos.cs                   Request/Response + Validate [Range], [Required]
├── Migrations/                    sinh bởi dotnet ef migrations add
├── Program.cs
└── appsettings.json               ConnectionStrings + Jwt

1.4. Ba điểm BẮT BUỘC trong Program.cs để chạy được trên host

(1) Bật Swagger ở mọi môi trường – mặc định template chỉ bật Swagger khi Development, lên host (Production) sẽ bị 404. Hãy bỏ điều kiện if (app.Environment.IsDevelopment()).

(2) Tự động chạy Migration khi khởi động – vì database của host chỉ cho phép kết nối nội bộ, cách đơn giản nhất là để ứng dụng tự tạo bảng khi chạy lần đầu.

(3) Endpoint /health – dùng để "đánh thức" server (MonsterASP tự tắt app khi không có truy cập).

var app = builder.Build();

// (2) Tự chạy EF Core migrations -> tạo bảng Users, PlayerProfiles trên DB của host
using (var scope = app.Services.CreateScope())
{
    scope.ServiceProvider.GetRequiredService<AppDbContext>().Database.Migrate();
}

// (1) Bật Swagger cả trên Production để giảng viên test
app.UseSwagger();
app.UseSwaggerUI();

app.UseCors();
app.UseAuthentication();
app.UseAuthorization();

app.MapGet("/", () => Results.Redirect("/swagger"));
app.MapGet("/health", () => Results.Ok(new { status = "ok" }));   // (3)
app.MapControllers();
app.Run();

1.5. Tạo Migration

dotnet ef migrations add InitialCreate

Lệnh trên sinh thư mục Migrations/. Không cần chạy dotnet ef database update lên host – ứng dụng sẽ tự gọi Database.Migrate() khi khởi động.

Phần 2. Đăng ký tài khoản MonsterASP.NET

Bước 1. Truy cập trang chủ

Mở https://www.monsterasp.net và bấm nút Sign-up for FREE.

Trang chủ MonsterASP.NET – bấm Sign-up for FREE
Hình 1. Trang chủ MonsterASP.NET – bấm Sign-up for FREE

Bước 2. Điền form đăng ký

  1. Nhập Email address (nên dùng Gmail cá nhân).
  2. Tick ô Verify you are human (Cloudflare).
  3. Bấm Create account.
  4. Mở hộp thư, lấy mã kích hoạt / link kích hoạt MonsterASP gửi về (xem cả mục Spam), sau đó đặt mật khẩu cho tài khoản.
Form đăng ký – chỉ cần email, không cần thẻ tín dụng
Hình 2. Form đăng ký – chỉ cần email, không cần thẻ tín dụng

Bước 3. Đăng nhập Control Panel

Vào https://admin.monsterasp.net, nhập E-mail, Password, chờ Cloudflare xác minh rồi bấm Login to Control panel.

Trang đăng nhập Control Panel
Hình 3. Trang đăng nhập Control Panel

Quên mật khẩu? Bấm Forgot your password? ở trang đăng nhập → nhập email → Send password reset → mở email và đặt mật khẩu mới.

Gửi yêu cầu đặt lại mật khẩu – hệ thống báo đã gửi link về email
Hình 4. Gửi yêu cầu đặt lại mật khẩu – hệ thống báo đã gửi link về email

Bước 4. Màn hình Dashboard

Sau khi đăng nhập, Dashboard hiển thị các dịch vụ: Websites, Databases, E-mails, DNS. Gói Free cho phép tạo website và tối đa 5 database miễn phí. Bấm New website để bắt đầu.

Dashboard – bấm New website
Hình 5. Dashboard – bấm New website

Phần 3. Tạo website miễn phí

Bước 5. Chọn gói FREE

Trình hướng dẫn Create website có 6 bước: Plan → Domain → DNS → Subscription → Location → Example. Ở bước Plan, chọn thẻ FREE (5 GB, 256 MB RAM, datacenter EU).

Chọn gói FREE – Hosting for testing
Hình 6. Chọn gói FREE – Hosting for testing

Kéo xuống cuối thẻ và bấm Select FREE website.

Bấm Select FREE website
Hình 7. Bấm Select FREE website

Bước 6. Đặt tên miền (subdomain)

  1. Giữ lựa chọn Free subdomain.
  2. Ô Website address: nhập tên (chữ thường, số, dấu gạch ngang, tối thiểu 3 ký tự). Ví dụ: playersave-demo. Gợi ý cho sinh viên: msv-hoten-game.
  3. Ô Website free subdomain: chọn .runasp.net hoặc .tryasp.net.
  4. Kiểm tra dòng Your website address rồi bấm Continue.
Nhập tên website và chọn subdomain
Hình 8. Nhập tên website và chọn subdomain

Bước 7. Chọn Datacenter

Gói Free chỉ có Europe Datacenter (đã được chọn sẵn). Bấm Continue.

Datacenter Châu Âu – mặc định cho gói Free
Hình 9. Datacenter Châu Âu – mặc định cho gói Free

Bước 8. Chọn ứng dụng mẫu

Chọn My own application (website trống để upload code của mình) rồi bấm Create Website.

Chọn My own application → Create Website
Hình 10. Chọn My own application → Create Website

Website xuất hiện trong danh sách với trạng thái Creating, sau khoảng 1 phút chuyển sang Enabled. Ghi lại mã site (ví dụ site107840).

Website mới tạo trong danh sách Websites
Hình 11. Website mới tạo trong danh sách Websites

Phần 4. Tạo database MSSQL miễn phí

Bước 9. Chọn gói FREE cho Database

Menu trái → Databases → Add database. Chọn thẻ FREE (1 GB) và bấm Select FREE database ở cuối thẻ.

Create database – chọn gói FREE
Hình 12. Create database – chọn gói FREE

Bước 10. Chọn loại Database

Chọn SQL Server 2025 (MSSQL) – phù hợp nhất với Entity Framework Core. Giữ nguyên Collation SQL_Latin1_General_CP1_CI_AS và User language English, bấm Continue.

Nếu muốn dùng PostgreSQL/MySQL thì đổi package EF Core tương ứng (Npgsql.EntityFrameworkCore.PostgreSQL / Pomelo.EntityFrameworkCore.MySql) và tạo lại migration.

Chọn SQL Server 2025 (MSSQL)
Hình 13. Chọn SQL Server 2025 (MSSQL)

Bước 11. Chọn Datacenter và tạo

Chọn Europe Datacenter (cùng nơi với website) rồi bấm Create Database.

Bấm Create Database
Hình 14. Bấm Create Database

Database được tạo với tên dạng dbXXXXX.databaseasp.net. Bấm Manage để xem thông tin kết nối.

Database MSSQL đã ở trạng thái Enabled
Hình 15. Database MSSQL đã ở trạng thái Enabled

Bước 12. Lấy Connection String

Trong tab Local access có Server, Login, Password và khung CONNECTION STRING. Bấm Show with password rồi bấm biểu tượng copy để sao chép.

Thông tin kết nối Local access và Connection string
Hình 16. Thông tin kết nối Local access và Connection string

Dán vào appsettings.json của project, thêm TrustServerCertificate=True:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=db80020.databaseasp.net; Database=db80020; User Id=db80020; Password=<MẬT_KHẨU_DB>; Encrypt=False; MultipleActiveResultSets=True; TrustServerCertificate=True;"
  },
  "Jwt": {
    "Key": "<chuỗi bí mật dài tối thiểu 32 ký tự>",
    "Issuer": "PlayerSaveApi",
    "Audience": "UnityClient"
  }
}

Lưu ý quan trọng:

• Server dbXXXXX.databaseasp.net ở tab Local access là hostname nội bộ – chỉ website chạy trên MonsterASP mới kết nối được. Chạy thử trên máy cá nhân sẽ báo lỗi kết nối, đó là bình thường.

• Muốn kết nối từ máy (SSMS, dotnet ef database update) hãy dùng thông tin ở tab Remote access.

• Không commit mật khẩu DB và Jwt:Key lên GitHub công khai.

Phần 5. Đóng gói sản phẩm (publish)

Bước 13. Publish bằng dòng lệnh

Mở Terminal tại thư mục project và chạy:

dotnet publish -c Release -o publish

Thư mục publish/ chứa PlayerSaveApi.dll, các thư viện, appsettings.json, thư mục runtimes/ và đặc biệt là file web.config (IIS dùng file này để chạy ứng dụng ASP.NET Core):

<aspNetCore processPath="dotnet" arguments=".\PlayerSaveApi.dll"
            stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />

Bước 14. Nén thành file .zip

Nén nội dung bên trong thư mục publish (không nén cả thư mục cha), để sau khi giải nén file web.config nằm ngay trong wwwroot.

Hệ điều hànhLệnh nén
Windows (PowerShell)Compress-Archive -Path .\publish\* -DestinationPath .\PlayerSaveApi.zip -Force
macOS / Linuxcd publish && zip -r ../PlayerSaveApi.zip . && cd ..

Cách khác với Visual Studio: chuột phải project → Publish → Target Folder → Publish, sau đó nén thư mục output. Hoặc dùng Web Deploy: tab Visual Studio access trong trang quản lý website cung cấp file publish profile để import vào Visual Studio.

Phần 6. Upload và giải nén lên host

Bước 15. Mở trang quản lý Website

Websites → bấm Manage ở website vừa tạo. Trang Overview hiển thị thông tin FTP/SFTP (server siteXXXXX.siteasp.net, thư mục gốc \wwwroot). Bấm menu Files (File manager).

Trang quản lý website – chọn Files
Hình 17. Trang quản lý website – chọn Files

Bước 16. Vào thư mục wwwroot

Bấm vào thư mục wwwroot (thư mục chứa ứng dụng), sau đó bấm Upload file.

File manager – mở wwwroot rồi bấm Upload file
Hình 18. File manager – mở wwwroot rồi bấm Upload file

Bước 17. Upload file zip

Bấm vùng Click to choose a file (hoặc kéo thả) và chọn PlayerSaveApi.zip. Kiểm tra dòng Uploading to: /wwwroot/.

Hộp thoại Upload file
Hình 19. Hộp thoại Upload file

Bước 18. Giải nén (Unzip)

Sau khi thấy thông báo File was uploaded, bấm nút Unzip trên dòng PlayerSaveApi.zip.

File zip đã upload – bấm Unzip
Hình 20. File zip đã upload – bấm Unzip

Kiểm tra Extract to: /wwwroot/, giữ tick Overwrite existing files và Restart application pool before extracting (tránh lỗi file DLL bị khoá khi deploy lại), bấm Unzip.

Giải nén vào /wwwroot/
Hình 21. Giải nén vào /wwwroot/

Kết quả: wwwroot chứa thư mục runtimes, appsettings.json, web.config, các file .dll… Có thể xoá file PlayerSaveApi.zip sau khi giải nén để tiết kiệm dung lượng.

Các file ứng dụng đã nằm trong wwwroot
Hình 22. Các file ứng dụng đã nằm trong wwwroot

Deploy lại phiên bản mới: chạy lại Bước 13 → 18. Nhớ tick Restart application pool khi Unzip.

Cách upload khác: WebFTP (https://webftp.monsterasp.net), FileZilla (SFTP cổng 22), Web Deploy từ Visual Studio hoặc Git deploy từ GitHub.

Phần 7. Bật HTTPS (Let's Encrypt)

Bước 19. Mở mục HTTPS

Trong trang quản lý website, chọn menu HTTPS. Ban đầu domain ở trạng thái HTTP only. Bấm Enable HTTPS.

Trang HTTPS – domain đang ở trạng thái HTTP only
Hình 23. Trang HTTPS – domain đang ở trạng thái HTTP only

Bước 20. Gói Free: gửi yêu cầu kích hoạt

Với gói Free, HTTPS không bật tự động mà cần mở Support ticket để yêu cầu kích hoạt thủ công. Bấm Open Support ticket.

Gói Free cần mở ticket để yêu cầu bật HTTPS
Hình 24. Gói Free cần mở ticket để yêu cầu bật HTTPS

Bước 21. Điền và gửi ticket

Điền Subject, Describe your issue, chọn Related service là website của bạn rồi bấm Open ticket. Nội dung mẫu:

Subject: Please enable free HTTPS (Let's Encrypt) for <ten-cua-ban>.runasp.net

Hello MonsterASP team,
I'm hosting an ASP.NET Core Web API (student project) on the Free plan
at <ten-cua-ban>.runasp.net (siteXXXXX).
Could you please enable the free Let's Encrypt HTTPS certificate for this domain?
Thank you very much!
Form Open Support Ticket
Hình 25. Form Open Support Ticket

Phản hồi sẽ gửi về email. Khi domain đã chuyển sang HTTPS, quay lại mục HTTPS và bật HTTPS Redirect = Enabled để tự chuyển http:// sang https://.

Nên gửi ticket sớm (ngay sau khi tạo website) vì có thể mất từ vài giờ đến 1–2 ngày. Trong lúc chờ, API vẫn hoạt động qua http://. Trình duyệt Chrome có thể cảnh báo "Kết nối không an toàn" – bấm Tiếp tục truy cập trang web để mở Swagger.

Phần 8. Kiểm tra API sau khi deploy

8.1. Kiểm tra nhanh

  • http(s)://ten-cua-ban.runasp.net/health → trả về {"status":"ok"}. Lần gọi đầu có thể mất vài giây do server khởi động (cold start).
  • http(s)://ten-cua-ban.runasp.net/swagger → giao diện Swagger UI liệt kê đủ 5 endpoint.

8.2. Test luồng trên Swagger

  1. POST /api/auth/register → Try it out → nhập {"username":"sv01","password":"123456","displayName":"Nguyễn Văn A"} → Execute → 201.
  2. Gọi lại với cùng username → 409 Conflict.
  3. POST /api/auth/login → nhận token, copy chuỗi token.
  4. Bấm nút Authorize (ổ khoá) ở đầu trang → dán token → Authorize.
  5. GET /api/player/profile → 200, Level=1, Gold=0, HighScore=0.
  6. PUT /api/player/save với {"level":2,"gold":100,"score":500} → HighScore = 500.
  7. GET /api/leaderboard?top=10 → danh sách chỉ gồm displayName, level, highScore.

8.3. Kết quả kiểm tra thực tế trên bản demo

RequestKết quảStatus
POST /api/auth/register (user mới){"message":"Đăng ký thành công", ...}201
POST /api/auth/register (trùng username){"message":"Username đã tồn tại"}409
POST /api/auth/login (sai mật khẩu){"message":"Sai username hoặc mật khẩu"}401
POST /api/auth/login (đúng){"token":"eyJhbGciOi...","expiresAt":...}200
GET /api/player/profile (không có token)—401
GET /api/player/profile (có token){"displayName":"Nguyễn Văn A","level":1,"gold":0,"highScore":0}200
PUT /api/player/save score=500highScore: 500200
PUT /api/player/save score=200 (thấp hơn)highScore vẫn 500200
PUT /api/player/save gold=-5Validation error: Gold must be between 0 and ...400
GET /api/leaderboard?top=10[{"displayName":"Nguyễn Văn A","level":2,"highScore":500}]200

Phần 9. Kết nối Unity tới API đã deploy

Đặt Base URL là tên miền đã deploy (không dùng localhost) và tăng timeout để chịu được cold start:

public static class ApiConfig
{
    public const string BaseUrl = "https://playersave-demo.runasp.net"; // đổi thành domain của bạn
    public static string Token;                                         // lưu sau khi login
}

IEnumerator GetProfile()
{
    using var req = UnityWebRequest.Get($"{ApiConfig.BaseUrl}/api/player/profile");
    req.SetRequestHeader("Authorization", "Bearer " + ApiConfig.Token);
    req.timeout = 60;                       // server có thể đang "ngủ"
    loadingPanel.SetActive(true);
    yield return req.SendWebRequest();
    loadingPanel.SetActive(false);

    if (req.result == UnityWebRequest.Result.Success)
    {
        var p = JsonUtility.FromJson<ProfileResponse>(req.downloadHandler.text);
        // hiển thị p.displayName, p.level, p.gold, p.highScore
    }
    else if (req.responseCode == 401) ShowError("Phiên đăng nhập hết hạn, vui lòng đăng nhập lại");
    else ShowError("Lỗi mạng / server timeout: " + req.error);
}

Mẹo cold start: khi mở game, gọi trước GET /health (timeout 60s) để đánh thức server rồi mới hiện màn hình đăng nhập. Nếu HTTPS chưa được bật, Unity mặc định chặn http:// – tạm thời đổi Project Settings → Player → Allow downloads over HTTP thành Always allowed (chỉ dùng khi test).

Phần 10. Lỗi thường gặp và cách xử lý

Hiện tượngNguyên nhânCách xử lý
HTTP Error 500.30 – ASP.NET Core app failed to startSai connection string, migration lỗi, thiếu file khi giải nénKiểm tra lại appsettings.json; sửa web.config stdoutLogEnabled="true", tạo thư mục logs trong wwwroot rồi xem file log
/swagger trả về 404UseSwagger() nằm trong if (IsDevelopment())Bỏ điều kiện, publish và upload lại
Lỗi kết nối DB khi chạy ở máy cá nhânServer dbXXXX.databaseasp.net là hostname nội bộBình thường – dùng thông tin Remote access nếu cần kết nối từ máy
Unzip báo file đang bị khoáApp đang chạy giữ file .dllTick Restart application pool before extracting
Request đầu tiên rất chậm / Unity timeoutServer tự tắt khi không có truy cập (idle shutdown)request.timeout = 60; gọi /health trước
401 Unauthorized dù đã loginThiếu header hoặc sai định dạngHeader phải là Authorization: Bearer <token> (có dấu cách sau Bearer)
Chrome báo "Kết nối không an toàn"HTTPS chưa được bậtGửi ticket bật HTTPS (Phần 7); tạm thời bấm Tiếp tục truy cập
Website bị Archived6 tháng không hoạt độngVào Websites → Manage để khôi phục, hoặc tạo website mới

Checklist trước khi nộp bài

  • ☐ Link Swagger công khai mở được (https://ten-cua-ban.runasp.net/swagger).
  • ☐ Đủ 5 endpoint, trả đúng status code 200/201/400/401/404/409.
  • ☐ Migrations có trong source code; bảng Users và PlayerProfiles được tạo trên DB host.
  • ☐ Unity build/Editor gọi API bằng URL đã deploy, có Loading và thông báo lỗi.
  • ☐ README.md ghi: link API, link Swagger, tài khoản test, cách chạy project Unity.
  • ☐ Không để lộ mật khẩu DB / Jwt:Key trên repo công khai.
Ảnh Nguyễn Hữu Huy

Tác giả

Giảng viên Khoa Công nghệ Thông tin, Cao đẳng FPT Polytechnic

Thầy Huy dạy lập trình tại Cao đẳng FPT Polytechnic, chia sẻ kiến thức về Android, Unity/C#, AI và lập trình backend qua blog dotplays và kênh YouTube Thầy Huy One Champ. Tác giả các ứng dụng dotsave, getvidfb và taptik.