Awesome Open Source
Awesome Open Source

Moonglade Blog

Build Status Docker Build and Push .NET Build Linux Azure DevOps coverage

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.

📦 Deployment

It is recommended to use stable code from Release rather than master branch.

☁ Full Deploy on Azure (Recommend)

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.

image

🐋 Quick Deploy on Azure

Use automated deployment script to get your Moonglade up and running in 10 minutes, follow instructions here

🐧 Quick Deploy on Linux without Docker

To quickly get it running on a new Linux machine without Docker, follow instructions here.

🐵 Development

Tools Alternative
Visual Studio 2019 v16.10+ Visual Studio Code with .NET 5.0 SDK
SQL Server 2019 SQL Server LocalDB

💾 Setup Database

Create a SQL Server 2019 or LocalDB 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;"

🔨 Build Source

Build and run ./src/Moonglade.sln

  • Admin entrance: https://localhost:1055/admin
  • Default username: admin
  • Default password: admin123

⚙ Configuration

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.

🛡 Authentication

Azure Active Directory

See Wiki document

Local Account (Alternative)

Set Authentication:Provider to "Local". You can manage accounts in /admin/settings/account

🖼 Image Storage

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.

File System (Not Recommended)

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",
"FileSystemSettings": {
  "Path": "${basedir}\\UploadedImages"
}

The Path can be relative or absolute. "$\{basedir\}" represents the website's current directory.

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
}

🤬 Comment Moderator

📧 Email Notification

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.

🔩 Others

🎉 Blog Protocols or Standards

  • [X] RSS
  • [X] Atom
  • [X] OPML
  • [X] Open Search
  • [X] Pingback
  • [X] Reader View
  • [X] FOAF
  • [X] RSD
  • [X] MetaWeblog (Basic Support)
  • [ ] BlogML - Under triage
  • [ ] APML - Not planned
  • [ ] Trackback - Not planned

🐼 Example Blogs

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

💰 Donate

  • BTC: 1JaPGHK3SjDTirTedyBVf5APG1ibC1YXUq
  • BTC(ERC20): 0xe9cb050c62631f9ed8a1d504532dfe9593192c39
  • USDT(ERC20): 0xe9cb050c62631f9ed8a1d504532dfe9593192c39
  • USDT(TRC20): TR6yDNh6yYgasdJPsFp3HUXTbqGoK3RPLN
  • ETH: 0xe9cb050c62631f9ed8a1d504532dfe9593192c39
  • DOGE: DC8ngV41D97CXk8nxo9yxeMqU1UN52jt6Y
  • SHIB(ERC20): 0xe9cb050c62631f9ed8a1d504532dfe9593192c39

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Sharp (276,133) 
Dotnet Core (4,295) 
Azure (4,187) 
Asp Net Core (3,650) 
Entity Framework Core (787) 
Azure Devops (512) 
Azure Active Directory (178) 
Azure App Services (162) 
Related Projects
Advertising 📦 9
All Projects
Application Programming Interfaces 📦 120
Applications 📦 181
Artificial Intelligence 📦 72
Blockchain 📦 70
Build Tools 📦 111
Cloud Computing 📦 79
Code Quality 📦 28
Collaboration 📦 30
Command Line Interface 📦 48
Community 📦 81
Companies 📦 60
Compilers 📦 60
Computer Science 📦 74
Configuration Management 📦 39
Content Management 📦 167
Control Flow 📦 197
Data Formats 📦 77
Data Processing 📦 266
Data Storage 📦 132
Economics 📦 60
Frameworks 📦 198
Games 📦 122
Graphics 📦 103
Hardware 📦 148
Integrated Development Environments 📦 47
Learning Resources 📦 147
Legal 📦 28
Libraries 📦 119
Lists Of Projects 📦 21
Machine Learning 📦 336
Mapping 📦 61
Marketing 📦 15
Mathematics 📦 55
Media 📦 228
Messaging 📦 97
Networking 📦 304
Operating Systems 📦 84
Operations 📦 120
Package Managers 📦 52
Programming Languages 📦 229
Runtime Environments 📦 96
Science 📦 42
Security 📦 375
Social Media 📦 26
Software Architecture 📦 70
Software Development 📦 68
Software Performance 📦 57
Software Quality 📦 127
Text Editors 📦 45
Text Processing 📦 131
User Interface 📦 310
User Interface Components 📦 465
Version Control 📦 29
Virtualization 📦 68
Web Browsers 📦 38
Web Servers 📦 25
Web User Interface 📦 194