The .NET blog system of edi.wang that runs on Microsoft Azure. Designed for developers, enabling most common blogging features including posts, comments, categories, archive, tags and pages.
It is recommended to use stable code from Release rather than master branch.
This is the way https://edi.wang is deployed, by taking advantage of as many Azure services as possible, the blog can run very fast and secure.
This diagram shows a full Azure deployment for Moonglade for reference.
Use automated deployment script to get your Moonglade up and running in 10 minutes, follow instructions here
To quickly get it running on a new Linux machine without Docker, follow instructions here.
Tools | Alternative |
---|---|
Visual Studio 2022 v17.0+ | Visual Studio Code with .NET 6.0 SDK |
SQL Server 2019 | SQL Server LocalDB or MySQL |
Create a SQL Server 2019, a LocalDB, or an MySQL database. e.g. moonglade
Update the MoongladeDatabase
with your database connection string in appsettings.Development.json
"MoongladeDatabase": "Server=(localdb)\\MSSQLLocalDB;Database=moonglade;Trusted_Connection=True;"
To use MySQL, set DatabaseType
to MySql
"DatabaseType": "MySql"
example MySQL connection string:
"MoongladeDatabase": "Server=localhost;Port=3306;Database=moonglade;Uid=root;Pwd=******;"
Build and run ./src/Moonglade.sln
- Admin entrance:
https://localhost:1055/admin
- Default username:
admin
- Default password:
admin123
This section discuss system settings in appsettings.[env].json. For blog settings, please use "/admin/settings" UI.
For production, it is strongly recommended to use Environment Variables over appsetting.json file.
See Wiki document
Set Authentication:Provider
to "Local"
. You can manage accounts in /admin/settings/account
AppSettings:ImageStorage
controls how blog post images are stored.
Azure Blob Storage (Preferred)
You need to create an Azure Blob Storage with container level permission.
{
"Provider": "azurestorage"
"AzureStorageSettings": {
"ConnectionString": "YOUR CONNECTION STRING",
"ContainerName": "YOUR CONTAINER NAME"
}
}
When configured the image storage to use Azure Blob, you can take advantage of CDN for your image resources. Just enable CDN in admin settings, the blog will get images from client browser using a 302 redirect.
You can also choose File System for image storage, but this will make your site root not read-only, which would be a potential security issue. And it will be harder for you to backup or update the website.
{
"Provider": "filesystem",
"FileSystemPath": "C:\\UploadedImages"
}
The Path
can be relative or absolute.
Minio Blob Storage (Free)
You need to hava an Minio Server.
"Provider": "miniostorage"
"MinioStorageSettings": {
"EndPoint": "Minio Server Endpoint(eg:localhost:9600)",
"AccessKey": "Your Access Key",
"SecretKey": "Your Secret Key",
"BucketName": "Your BucketName",
"WithSSL": false
}
Qiniu Blob Storage (Almost free)
You need to hava an Qiniu cloud account, and use Kodo storage service.
"Provider": "qiniustorage"
"QiniuStorageSettings": {
"EndPoint": "Your Custom Domain",
"AccessKey": "Your Access Key",
"SecretKey": "Your Secret Key",
"BucketName": "Your BucketName",
"WithSSL": false
}
If you need email notification for new comments, new replies and pingbacks, you have to setup the Moonglade.Notification Azure Function first, and then enable notification in admin portal.
- RSS
- Atom
- OPML
- Open Search
- Pingback
- Reader View
- FOAF
- RSD
- MetaWeblog (Basic Support)
- BlogML - Under triage
- APML - Not planned
- Trackback - Not planned
There are a few individuals already setup thier blogs using Moonglade on Azure (Global or China), Alibaba Cloud, Tencent Cloud, etc.
Just Submit PR or issue if you want your blog to be listed here