Giter Site home page Giter Site logo

ediwang / moonglade Goto Github PK

View Code? Open in Web Editor NEW
501.0 15.0 137.0 19.28 MB

The ASP.NET Core blog system of https://edi.wang, runs on Microsoft Azure

Home Page: https://edi.wang

License: GNU General Public License v3.0

C# 53.86% HTML 35.33% CSS 4.74% JavaScript 4.38% PowerShell 1.44% Dockerfile 0.14% TSQL 0.11%
azure azure-app-service aspnet-core entity-framework-core azure-sql-database azure-application-insights azure-blob-storage azure-frontdoor blog sql-server

moonglade's Introduction

Moonglade Blog

Docker Linux x64 Man hours

A personal blog system that optimized for Microsoft Azure. Designed for developers, enabling most common blogging features including posts, comments, categories, archive, tags and pages.

📦 Deployment

  • Use stable code from Release branch rather than master branch.

  • HTTPS is required, and it is recommended to enable HTTP/2 support on your web server.

Full Deploy on Azure

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.

There is no automated script to deploy it, you need to manually create all the resources.

image

Quick Deploy on Azure (App Service on Linux)

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

Quick Deploy with Docker-Compose

Simply go the the root folder of this repo and run:

docker-compose build
docker-compose up

That's it! Now open: Browser: http://localhost:8080

🐵 Development

Tools Alternative
Visual Studio 2022 Visual Studio Code with .NET 8.0 SDK
SQL Server 2022 SQL Server LocalDB, PostgreSQL or MySQL

Setup Database

You can choose from SQL Server, PostgreSQL or MySQL. Update your database connection string in appsettings.json, ConnectionStrings section.

Database DatabaseType MoongladeDatabase Example
Microsoft SQL Server SqlServer Server=(localdb)\\MSSQLLocalDB;Database=moonglade;Trusted_Connection=True;
MySQL MySql Server=localhost;Port=3306;Database=moonglade;Uid=root;Pwd=***;
PostgreSQL PostgreSql User ID=***;Password=***;Host=localhost;Port=5432;Database=moonglade;Pooling=true;

Build Source

Build and run ./src/Moonglade.sln

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

⚙ Configuration

This section discuss environment settings in appsettings.json. For blog settings, please use "/admin/settings" UI.

Authentication

Moonglade is using local account by default, you can manage accounts in /admin/settings/account. You can also use Microsoft Entra ID to login. See Wiki document for setup Microsoft Entra ID.

Image Storage

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 CDN.

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
}

File System (Not Recommended)

You can also choose File System for image storage if you don't have a cloud option.

{
  "Provider": "filesystem",
  "FileSystemPath": "C:\\UploadedImages"
}

Comment Moderator

Setup Moonglade.ContentSecurity Azure Function to enable comment moderation.

"ContentModerator": {
  "Provider": "",
  "ApiEndpoint": "",
  "ApiKey": ""
}

Email Notification

Setup Moonglade.Email Azure Function to enable email notification for new comments, new replies and pingbacks. Then enable notification in admin portal.

"Email": {
  "ApiEndpoint": "",
  "ApiKey": ""
}

Others

🎉 Blog Protocols or Standards

Name Feature Status Service Endpoint
RSS Subscription Supported /rss
Atom Subscription Supported /atom
OPML Subscription Supported /opml
Open Search Search Supported /opensearch
Pingback Social Supported /pingback
Reader View Reader mode Supported N/A
FOAF Social Supported /foaf.xml
RSD Service Discovery Deprecated N/A
MetaWeblog Blogging Deprecated N/A
Dublin Core Metadata SEO Basic Support N/A
BlogML Blogging Not planned
APML Social Not planned
Trackback Social Not planned

免责申明

对于**用户,我们有一份特定的免责申明。请确保你已经阅读并理解其内容:

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.